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INTRODUCTION . 


The Dicom Floppy Disk System (FDS) is complemented by a complete 
line of supporting software for the Hewlett Packard 21XX Series 
computers. The FDS can be used as a peripheral in either the 
SIO or BCS environment, or it can be used as the primary I/O 
device under Dicom's Floppy Disk Operating System (FDOS). 


An operating system is an organized collection of programs 
which increases the PRODUCTIVITY of a computer system. An 
operating system's main function is to aid in the preparation, 
translation, debugging, loading, and execution of programs. 
This is accomplished by including a peripheral device in the 
system that can be completely controlled by the computer, thus. 
providing a large program/data base for use by the operating | 
system. In FDOS, up to a half-million words of random-access 
storage is provided via disk, with an additional half-million 
bytes of serial-access storage provided via cassettes. 


The various translators, loaders, and other software modules 

of the operating system are stored on the library device (in 
this case a disk) for use only when needed; thus the amount 

of core memory needed for efficient operation is significantly 
reduced. Since the operator requests a translator (assembler, 
compiler, etc.) from disk via an executive command typed 

on the console device keyboard (instead of loading it from paper 
tape), the overhead time can be significantly reduced and the 
efficiency can be significantly increased. Also, since the 
computer has complete control of the media containing the input 
data, the translation of the input data can be accomplished 
automatically, thus eliminating operator intervention and 
increasing system throughput (most translators must make multiple 


- passes over the input data). 


_FDOS is a collection of routines which control the operation of 


application programs and provide them with certain important 
capabilities, primarily in the area of access to peripheral 
devices, i.e., I/O. FDOS supports the HP Assembler, Cross- 
reference Table Generator, Editor, FORTRAN Compiler, and other 

HP and user-provided application programs. It allows these 
programs to perform I/O operations using a wide variety of 
peripheral equipment, including floppy disks, cassettes, paper 
tape, teletype and lineprinter. These devices are treated © 
uniformly by the operating system, so as to allow the application 
programs to be device-independent. | | 


FEATURES OF FDOS. 


* 


qimneatate usefulness; no / special languages or - complicated 
procedures to learn. . 


Immediate (random) access to all system programs. 


Uniform treatment of peripheral devices. 


Keyboard and batch processing modes. 


Small (approximately 1408 words) resident - eueten with all 
remaining memory available to user programs. . 


SIO driver package which combines console device, elopby disk, 
cassette, high-speed paper tape, and line printer drivers, 
using common routines to conserve memory. 


Standard programming packages integrated into FDOS, with 
complete floppy disk, cassette, paper tape, and line printer 
I/O facilities: includes editor, assemblers (Floating Point, 
EAU, and Non-EAU), cross-reference table generator, debugger, 
FORTRAN compiler, relocating loader, relocatable library, 

and others. Extender version also includes MAG. TAPE and 
CARD READER. | | i Su | 

Facilities for converting programs between the various media 
supported (paper tape, cones cassette). | 


Configurable for I/O configuration and memory size at system 
generation time. . 


MINIMUM FDOS HARDWARE CONFIGURATION 


* 


HP 21XX Series consutee with 8K of memory (DMA, EAU, memory 
parity, memory protect, time base cite Sane etc., are NOT 
required). 


Console device (HP-interfaced teleprinter or cassette system 
"deck zero" TTY/CRT). 


Single drive Floppy Disk Speen: 


ADDITIONAL HARDWARE SUPPORTED > 


* 


Up to a total of four floppy disk drives 


Up to a total of 32K memory . 


Dicom Caeesete Magnetic Tape System (CMTS) or Cassette 
Magnetic Tape Terminal COMET)» 


High-speed paper tape reader. 


High-speed paper tape punch. 


Line printer (HP-interfaced. and/or cassette system "deck sav 
line printer). 


Other peripheral devices with user-supplied SIO or BCS 
compatible drivers. 


EXTENDED VERSION OF FDOS — 


oe 
ay 


% 


Adds Magnetic Tape (one or two drives; V2 Santee 6740 67am LoD 
4S inches per second) and Optical Mark Sense (and) Punched 
Card Reader, I/O facilities, fully integrated. 


Requires only 4K additional core (12K minimum), and DMA, etc. 
Still not required (even with 45 ips Mag Tape). 


FDOS SOFTWARE MODULES 


The FDOS user is supplied: 


’. 
os 


as, 
ow 


Skeleton system disk containing: 


Configured FDOS for immediate use. 

Unconfigured Bootloader. 

System Generator. 

Unconfigured System header 

Unconfigured SIO Driver PAGKGES 

Unconfigured Executive. ia 

Assemblers (Floating point, EAU, and Non-EAU). 
Editor. 

Cross-Reference Table Generator. 

Debugger and Disk Utility Package. 

FORTRAN Compiler (Floating point, EAU and Non- EAU). 
Prepare Control System. 

Relocating Loader, BCS Drivers, and .I0C. 
Reloactable Libraries (Floating point, EAU, and Non-EAU). 


Diagnostic (on paper tape, cassette or disk) 
A configured, "standard" FDOS software system is provided with — 
a pre-determined hardware configuration; this allows the user 


to put the FDOS "on-the-air" immediately. 


The System Generator is run to produce a asapicuved Syaten 
Loader, SIO Driver package, and Executive. These can then 


be written out to the "System" files on 
System Generation process need not ever 


The Assemblers, Editor, Cross-Reference 


FORTRAN Compilers, Disk Prepare Control 
Loader modules are modified versions of 


disk, and the 
be performed again. 
Table Generator, 


System, and Relocating 
standard HP programs. 


The Relocatable Libraries, the .IOC. and BCS Drivers are 
unmodified HP programs. The Debugger is a stand-alone octal 
debugger designed for use either with an HP TTY, or with a 
cassette system "deck zero" console device. | | 


Il. FDOS ORGANIZATION 


The FDOS is a collection of programs designed to work together, 
giving the user a unified treatment of programs and data files. 
FDOS is specially designed to assist in the development and 
execution of programs. 


To this end an editor, assembler, FORTRAN compiler, debugger, 
and other software are stored on disk for quick access when 
needed. These programs are designed to use any FDOS I/O device 
for the various aspects of their input and output, and pro- 
grams generated by the assembler or FORTRAN compiler can later 
be integrated into the system. Such user-generated programs 
can be stored on disk, can make calls on system I/O drivers 

and other utility routines, and can communicate with the 
"Executive" for the purpose of accepting parameters at run time, 
of loading other programs, or of returning control to the 
"Executive". | 


It will be especially easy for CMTOS users to learn FDOS, 
since the commmand structures of the two operating systems are 
quite similar. | on ~ 


IIT.A. FDOS PERIPHERAL DEVICES 


The FDOS is designed to allow uniform handling of data from 
different peripheral devices regardless of the media involved. 
Under FDOS, each peripheral device (i.e., paper tape reader, 
paper tape punch, line printer, etc.) or sub-device (Teletype 
keyboard, Teletype printer, disk drives D, E, F, and G) is 
considered to be a physical device. 


In order to take maximum advantage of the disk drives, they are. 
broken down further. Each disk drive has four logical units 
assigned to it; Dl, D2, D3, D4, El, E2, .... . =, G4; each of 
these sixteen (possible) logical units are considered to be 
a physical device. Each of the logical units within each disk 
has an associated Logical Unit Directory (LUD) which resides on 
a certain fixed sector of each disk. The contents of each LUD,. 
which can be examined by the Logical Unit Directory command (LD), 
is a list of file names. Thus, for example, if the LUD for unit 
El consisted of the names : 

SRC1L 

SRC2 

SRC3 
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and the LUD for unit. E2 consisted of the names. 

SRC3 

SRC2 

| 3 SRC1_ | 

then a command to rewind logical unit El and copy three files 
from that unit to, say, cassette deck 2 would leave the three 
files SRC1,SRC2 and SRC3 on the cassette in deck 2 in the 
given order. If the same command were given using logical 
unit E2, then deck 2 would receive the same three files, but 
in the’ opposite order. 7 3 


In addition to the logical unit structure of disk cartridges | 
(drives), there is also a structure of named files. There is 

a Disk Directory, kept in a certain fixed disk sector, which . 
lists the names and locations of all files actually on that disk. 
A list of the names of ALL files actually on a specific disk can 
be obtained via the Disk Directory command, DI. It should be 
noted that the names of the files in the LUDs will only be printed 
IF there is actually data in the associated file. 


Peripheral devices of FDOS that are actually file-oriented, 

e.g. the cassette decks and the disk logical units, can contain © 
more than one file. To this end, commands are provided to posi- 
tion to specific files (Skip, Queue, Rewind, etc.), and to 
manipulate files (Copy, Verify, Save, List, etc.). ; 


- FDOS DEVICE STRUCTURING 


The uniformity in device handling is accomplished in FDOS by 
having two sets of devices: physical devices, which correspond 
to actual system hardware (peripheral devices), and functional 
devices, which correspond to tasks performed by the system. 


Programs such as the assembler refer only to functional devices. 
The system translates these I/O requests into operations on 
physical devices and handles all device-specific considerations. 
For example, the normal operation of the assembler requires it © 
to pesition the input unit, read through the file, position | 
the input unit again, read through the file again, producing — 
binary output on the punch unit, list output to the high- 

speed list unit or program list unit, write an EOF after the 
binary file on the punch unit, and, if no cross-reference has 
been requested, write an EOF after the list file on the high- 
speed list unit. The assembler does not need to make special 
“provision for paper tape input or output (such as halting | 
between TTY print and punch, generating leader/trailer, etc.). 
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It does not need to set up. a special pointer for’ lineprinter 
output, or avoid writing file marks on tape or disk when the 
listing has gone to the lineprinter. All it needs to do is 

make calls to the system I/O driver to implement the sequence of 
Operations specified above, and the system I/O driver handles 
all of these device peculiarities. 


This arrangement is similar to the HP BCS arrangement in which 
an EQT and an SQT are defined. 


The physical and functional units recognized by FDOS are | 
shown in Table II-l. This table is the key to understanding | 
FDOS device handling. The left side of the table shows all 

of the physical devices which can be supported by the system. 
Any particular system has some subset of these, specified at 
system generation time. | 


A table, called the Physical Device Table (PDT) is set up 
during system generation. For each of the devices on the left 
Side of table II-l, an entry in the PDT specifies its existence 
and capabilities on that particular system. For example, if 
the system has a high-speed reader but not a punch, the high. 
speed tape entry will show anpue capability but not output 
cepepatety: 


The right side of table II-1 lists the functional devices 
recognized by the system. The Functional Device Table (FDT) 
specifies which physical device is assigned to any given func- 
tional device, and also contains information about the binary 
vs. list capabilities of the particular functional device. 

A functional device can be either a binary device or a list- 
capable device. List-capable devices interpret I/O calls 
specifying negative counts as page control commands, while 
binary devices interpret these as commands to output in 
binary mode (B or BA, as specified in Section II.C). 


In the HP SIO environment a peculiar arrangement is provided . 
for formatting iui erie Normally an SIO driver accepts calls 
of the form . a | 7 | 

(A) = Data count 

(B) = Buffer address 

JSB Driver. | 
The data count specified is either the number of ASCII charac- 
ters to be output or minus the number of binary words to be 
output. That is, a negative. data count BER A teS that DanaLY 
data is to be output. 
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Certain devices, such as a lineprinter, are not normally used 
for binary output. The SIO drivers for such devices are pro- 
grammed to interpret certain "binary" calls as page spacing 
requests. The driver keeps track of the current page position 
by means of a line counter. When the line count reaches the 
maximum number of lines allowed on a page, the driver causes 
the device to do a “page eject", either by means of a Form | 
Feed, or by means of six Line Feeds. . 


In FDOS a similar page spacing facility is provided. Basically, 
paging properties are associated with functional units. Each 
functional unit has associated with it a 5-bit code which 
specifies 
(1) The unit is ee that is, no ‘page 
spacing requests are recognized, 
—---or--- | 
(2) The paging parameters: 
(a) three bits specifying one of. seven 
| (1 to 7) system line counters 
assigned to the unit; a line coun- 
ter of ¢g specifies no line counting 
(thus, no page spacing) for this 
unit. 
(b) two bits ee one of four 
page feed character options; 
i) L - an appropriate number of 
Line Feeds (to bring the line 
count to 66) is output, and the 
line counter is reset.  — | 
ii) F - a Form Feed... (ASCII 14) is 
output and the line counter is 
- reset. | | 
iii) N - no output accompanies the page 
advance. The line counter is reset. 
iv) xX - the extra page character 
(specified at System Generation 
Time) is output, and the line 
counter is reset. | 


The FDT entry for a list-capable units contains an index (between | 
@ and 7) to a table of line counts and a code for the choice of 
page feed character (Line Feed, Form Feed, ate or “extra page 
_ character"). : 


The FDT entry for any particular functional unit can be modi- 
fied by the operator by means of the assign (AS) command of the 


‘ Executive. 
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To use this command, the operator types 
AS FU,PU,LC,PC 


where FU = mnemonic code for the functional unit. © 
PU = mnemonic code for the physical unit. 
LC = index of the line counter. | 
PC = code for page character. 


If the LC and PC parameters are not specified, they are left 
alone in the FDT entry. Since the operator will almost never 
need to change these, the ordinary format of the AS command 
is simply | 


AS FU,PU 
to assign the physical device PU to the functional device FU. 
Since it is important for the operator to be able to keep track | 
of the FDT assignments, the Executive provides ways to do this. 
To find any given assignment, the operator can type : 
AS FU,? 
The system replies by typing 
PU . Name Line-counter Page-character 


where PU is the mnemonic code (see table II-1). If the operator 
wants the entire FDT printed, the command . 


LA UNIT 


can be used. The entire table is printed on "UNIT" with an | 
entry in the above format for each of the FDT entries. . 


In order that the user worry as little as possible about 

the FDT, a complete FDT is assembled with the Skeleton FDOS. — 
At System Generation time any of these can be modified by state- 
ments in the format used with the Assign command. (FU,PU,LC,PC). 


The FDT is stored in the "warm start" file on the system disk 
(S¥YS2). Thus, an X7542B, X7544B or X779@B restart will restore 

the FDT to its system generation time values, but an X7549B_ 

- restart, such as used by ASMB, EDIT, etc., to reload the Exec- 
utive, will not modify the FDT. | 7 | | 
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II.C. 


~FDOS DATA STRUCTURE oe 8 


All information stored or accessed by FDOS programs is . 
organized into files. These files are composed of records. 
A record is a collection of characters and must conform to one 
of four basic formats (which conform to standard HP.-philosophy): 
 * A - ASCII. Each record consists of 7-bit ASCII 
codes and ends with a line feed character (octal 12). 
On output, the eighth (parity) bit is always set. 
On input, the eighth (parity) bit is always cleared. 


* B - Relocatable binary. Each record consists of an 
even number of 8-bit characters, to be taken in pairs 
to represent 16-bit computer words. The first char- 
acter of each pair represents the most significant 
half (bits 15-8) of the corresponding word. © 


The first character (left half of the first word) of 
the record specifies the total number of words in the 
record. The third word of the record is the checksum 
(the sum of the second and fourth payougn the last words 
of the record). 


* BA - Absolute binary. Each record consists of an 
even number of 8-bit characters, to be taken in pairs 
to represent 16-bit computer words. The first character 
of each pair represents the most significant half 
(bits 15-8) of the corresponding word. | 


The first character (left half of the first word) — 
of the record specifies the total number of words in 
the record, minus 3. E.g., if there are 128 words 
in the record, this count will be 125. Absolute 
binary format differs from relocatable binary format 
in this respect. The last word: of the record is the 
checksum (the sum of the second through the next-to- 
last words of the record). 


* Fixed length binary (for BCS programs only). Each 
record consists of an even number of 8-bit characters, 
to be taken in pairs to represent 16-bit computer | 
words. The first character of each pair represents the. 
most significant half (bits 15-08) of the corresponding 
word. The record has no included word count; exactly 
as many words (or characters) are read as were asked 
for in the call. 


When taking input from paper tape, on which there are no 
physical record delimiters, the. data mode must be known in 
advance, and is used to determine record boundaries. Thus, 
e.g., a program reading an ASCII record will continue to take 
characters from the paper tape until a line feed character is 
encountered. If asked to read an absolute binary record, 

the program will take the first character read as a data word 
count (n), fill out the first word with the second character 
from tape, read the next 2(n+2) characters as the next (nt+2) 
words of the record. The checksum considerations mentioned 

in the above description would not be performed by an 1/0 
driver asked to read a record in absolute or relocatable binary 
format. Instead, the (n+3) or (n) words of the record are 
simply transmitted to the calling program, which can then per- 
form the checksum computation itself. 


The file structure of the disk follows the paper Pape record > 
format more closely than the cassette format, since no special 
record delimiters are recognized by the disk hardware. The 
disk structure supported by the hardware is. its division into 
tracks and sectors.- The number of sectors per track is a 

_ power of two, and the "disk address" contains the sector address — 
in the least significant portion of the word with the track 
address in the next most significant bits. For this reason, . 
the division into tracks is largely unimportant to the software, 
and we speak of the disk address or sector ene dag hel (of data with- 
out explicit mention of the track. 


A disk sector contains 128 16- Die words ; these are “assigned in 
FDOS as follows: | 


First word: "Name"; A word derived from the file 
name and serving as a validity Check: 


Second word: "Pointer"; Sector address of ‘the next 
-128-word block of the file. Zero denotes 
end-of-file.. 


Remaining 126 words: Data words 


The data words are used for storing information in the same 
format as used with paper tape. Thus, a disk file can be 
thought of as a paper tape laid out on the disk in a "chain" 

of sectors. The first sector contains the first 252 characters 
of the "tape" in its third through 128-th words. The 253-rd 
through 504-th characters are in the third through 128-th 

words of the second block, and so on. The last block of the 
file contains an end-of-file indication in its "pointer" word, 
marking the end of the "tape", and unused characters of the 
last block are filled with nulls, the "trailer" of the "tape". 


Since the blocks of a disk file are chained together, it is 
only necessary to record the address of the first block of the 
file. This is the function of the disk directory. The disk 
directory contains a four-word entry for each file on the disk. 
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Three words are for the name; the fourth contains the sector 
address of the first block of the file. 


In order to go through a file of data stored in this manner it 
is only necessary to know. the location of the first. sector, 
since each sector contains a pointer to the next sector of. 
the file. The disk directory stored in track zero, sector 

1 of each disk, contains the names (up to five characters) 
‘and starting sectors of the files on that disk. 


The structure of files described above is appropriate to the 
random-access nature of the disk media. Many programs, however, 
are designed for use with a sequential access device. FORTRAN | 
statements such as REWIND and ENDFILE have direct interpreta- 


tions for cassettes but not for disks. Similarly, programs 
running in an SIO. environment have no means of making random- 
access references to their I/O units. Thus, in order to achieve. 


-uniform treatment of all system I/0 devices wherever possible, 
a system of "logical units" has been established for each disk. 


There are four logical units on each disk. Each has assigned. 

a sector in which its "logical unit directory" or LUD is’ 
stored. This LUD is a list of file names in a specific order. 
Those files, in that order,constitute the given logical unit, 
making it a sequential access device. The contents of the LUD's 
and therefore the files in these logical units, are under con- 
trol of the user (see QU, AQ, and LD commands). | 


II~8 


6-iIf 


ge 


*T-IIT eTqeL 


SHOIAGG IWOISAHd ANV 'IVNOI“ONNA SoOdi 


CMTS Deck @ 

CMTS Deck 1 

CMTS Deck 2 

CMTS Deck 3 

High-speed Paper Tape 
Low-speed (TTY) Paper Tape 
Teletype keyboard/printer 
_Lineprinter 

Mag. Tape Unit @ ceetended 
Mag. Tape Unit 1 (extended) 
Card Reader (extended) 


Unused 


Nonexistent Device 
Bit Bucket 
a ee Unit D4 
tt W DL 
ig TNE ay? 
" D3 
, "  E4 
eal Bd 
“ 2 
i " B3 
‘ "  F4 
" " FL 
, ™ 2 
1. oo F3 
Oe Me Ga 
" we Gal. 
G2 


G3 


49 
Al 
A2 
43 
44 


~ A5 


46 
AT 
5p 
51 
52 
53 
54 
55 
56 
57 
6g 
61 
62 
63 
64 
65 
66 
67 


7p 


eg 


72 
73 


74 


73 
76 


77 


Data Input 


PHYSICAL DEVICES FUNCTIONAL DEVI CES 


Program List 
Data Output 
Program Keyboard 
High-speed List 


Scratch 

Executive 
Executive 
Auxiliary 
Auxiliary 
Auxiliary 
Auxiliary 
Auxiliary 
Auxiliary 


Keyboard 
Listing 

Input 

List 

Output 

Keyboard 
High-speed List 
Scratch 


Batch Command 
Batch Messages 


Unused 


II.E: TABLE II-2; SYSTEM TASK ASSIGNMENTS 


The functional devices are assigned to system tasks in the 
following way. 


l. Executive. 
CK On-line mode keyboard input. 
CL On-line mode executive messages. 
BC Batch mode command input. 
BM Batch mode executive messages. 


2. Assembler. 
DI Source input. 
DP Binary output. 
PL Talk to operator (e. g., "TYPE CONTROL STATE. ee 
Listings if HL not requested. 
PK Input from operator (e.g., ASMB. Jentina, 
HL Listing output unless PL specified. 


3. Editor 

DI Data input if "/D" specified. 

AI Data input if "/A" specified. 

DP Data output if "/D" specified. 

AP Data output if "/A" specified. 

PL Talk to operator. 

PK Answers from operator. 

ie Input of edit file if "/T" specified. 
AK Input of edit file if "/A" specified. 


4. Cross-reference Table Generator 
DI Source input. 
PI Talk to onenaron. 
Listings if HL not requested. 
PK Input from operator (e.g., symbol range). 
HL Listings unless PL specified. 


5. FORTRAN Compiler 
DI Source input. 
PL Talk to operator. 
Listings if HL not requested. 
SC Intermediate binary scratch file. 
HL List unless PL specified. 
DP Relocatable binary output. 
PK Input from operator. 


6. Disk Prepare Control System 

| DI Relocatable binary input. 
PL Talk to operator. 
DP Absolute binary output. 
PK Input from operator. 
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Tr, FDOS SOFTWARE STRUCTURE 
TIT: XR FDOS BOOTLOADER | 


The FDOS Bootloader is a short program which is stored 
in the protected area of memory. After the Bootloader 
has been configured (see Section V.D.), it is used 

to load the System Loader from disk; the Bootloader has 
a second entry that can be used to load a file from 
disk whose initial sector address is in the Switch Re- 
gister. A listing of the Bootloader is contained in 
an Appendix of this manual. : 


III.B. FDOS SYSTEM. LOADER: 


The FDOS System Loader is the core-resident portion 
of FDOS; it is used to load absolute binary files into 
memory from disk. Most FDOS systems programs (as well 
as user-added programs, if directed within the program) 
. return to a System Loader entry which causes the remain- 
der of the operating system to be loaded and executed. 
The System Loader is also used by the Run command of the 
FDOS Executive to load files from disk. A listing of 
the System Loader is contained in an Appendix of this 
manual. - . 


PIT eC. FDOS SIO DRIVER 


The SIO Driver provides device control and input and 
output of records in the ASCII, relocatable binary and 
absolute binary modes using disk logical units, cassettes, 
paper tape, Teletype, or lineprinter. It also provides 

a "system" entry, DIO, which accepts control commands 

and provides status returns (as opposed to SIO error 
halts). | | 


ETE ..Ds FDOS MEMORY LAYOUT | 


The FDOS System Loader resides near the top of memory; | 
it occupies locations X7534B through X7677B, where X = 
Le2sSw 26. a BOM BKe 12K, 16K 3 ce" Aes USE: Below at: in 
memory is the Communications Region, which is used for 
interprogram communication. Below that, going down to 
around X39@6B (depending upon the configuration) is the 
SIO Driver package. Programs which use the SIO Driver 
package (e.g., ASMB, EDIT, CROS) must preserve this 
area (th LWA of available memory can be found in. loca- 
tion 166B). The Executive is normally overlaid by these 
programs. The Executive resides in locations O4O09B 
through 12466B. Its restart address is O4AdOB. 
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The Extended Version of FDOS uses down to around 
X2600B for the SIO Driver package; the Executive 
resides in locations 10@60B through 16400B. Its 
restart address is 106@@B. 


These addresses for the Executive(s) are constant - 
it does not relocate during System Generation. The 
area from 8@2680B to the lower limit of the Executive 
is used as buffer space; the Executive does not over- 
lay page zero. 


The editor, assembler, etc., load into the lower 
portion of memory (preserving 1681B-104B and 106B) 

and use as much memory as they find available (the 
remainder minus the SIO Driver package, Communications 


- Region, and the Bootloader in the protected area of 


memory ). 
PDOS DISK LAYOUT 


The FDOS takes advantage of the removability of the 
floppy disk media by making each disk a self-contained 
entity. Each disk has a Disk Directory in track zero, 
sector one, and logical unit directories in track zero, 
sectors 4,5,6, and 7. These correspond, respectively, 
to logical units 4,1,2, and 3. In addition, five 
“fixed address files" (sectors 13B, 14B, 15B, 16B, and 
17B) are reserved for system use. The remaining sectors 
of the disk (2@B through 1777B) are originally placed 
on a free storage list, and then assigned to files as 
needed. 


FDOS EXECUTIVE 


The FDOS Executive provides batch or keyboard control 
of utility functions and program loading. Commands 
include copying of data from one device to another, 
control of cassettes or disk logical units, preparation 
and examination of directories, and running named files. 


MEMORY RELEASING 


The FDOS SIO Driver combines the drivers for the 

various peripherals supported into one Driver, thus | 
eliminating redundant (unnecessary) coding and conser-_ 
ving space. During System Generation (see Section V.F.) 
the user specifies which peripherals are not to be | 
used; the corresponding section of the SIO Driver is 
thus released, and the appropriate portions of FDOS are 
moved up to give the released area to the user. 


FDOS SOFTWARE STRUCTURE OVERVIEW 


FDOS is a software/hardware package designed to Sreviae 


the user of HP 2100 or related computers with the 
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utility functions necessary for the use of their com- 
puters with a wide variety of peripheral equipment. The 
FDOS software provides a modified SIO environment in 
which the Exec, Assembler, Editor, FORTRAN and associated 
programs run. It provides the necessary interface with 
the HP BCS environment, so that relocatable programs 
generated by FORTRAN or the Assembler can be loaded in 
the usual fashion and run on the same (or other, if 
desired) hardware as the FDOS SIO environment programs. 


The basic I/0 device of FDOS is the floppy disk. How- 
ever, SIO software is record-oriented. Furthermore, | 
FDOS achieves a uniform treatment of I/O devices. Thus, 
the FDOS disk format is designed to make disk files 
look like very long paper tapes. Each disk file is a 
chain of disk sectors (128 words per sector). The first. 
word of each sector is a file identifier derived from 
the file name. It is used by the driver for checking: 
file integrity. The second word of the sector is a 
pointer to the next sector of the file. Special codes 
mark End-of-File or End-of-Disk. The pointer contains 

a disk address (track and sector). No drive bits are 
included in the address, since a given disk cartridge 
can be inserted into any drive. 


The sectors of the disk are assigned to files from a 
list of free blocks, that is, a file composed of all 
of the unused sectors. The address of this free list 
and the names and addresses of all disk files are kept 
in the Disk Directory, which is stored in a certain 
fixed sector of each disk cartridge. | 


Files are attached to a logical unit by means of the 

QU and AQ commands. The files comprising a given logi- 
cal unit may or may not be actual disk files. Ifa 
file name appears in a LUD but is not an actual disk 
file, then a file with that name is created if output 
is directed to it. If input from a non-existent file 
is requested, an End-of-File condition occurs on that 
logical unit. : 


The disk logical units are sequential-access devices, 
designed to resemble tape drives. The files of a 
logical unit are in a fixed sequence. A rewind command 
positions the unit to the start of the first file of 
that unit. Reaching an End-of-File on a logical unit 
‘causes the unit to be positioned to the start of the . 
next file of that unit. Proceeding beyond the end of 
the last file of a logical unit creates an End-of-Tape 
condition. 
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-FDOS supports up to four floppy disk drives, each having 
four logical units. In addition to floppy disks, FDOS 
supports a variety of other peripheral devices. The 
various physical devices supported are assigned codes 

by which references to them are to be made in the var- 
ious Executive commands. The following codes and 
corresponding physical devices are recognized by the 
Executive: . 


6 CMTS Deck Zero. This is the "off-line" device 
of the Dicom Cassette Magnetic Tape System. 
Normally either a console (CRT or TTY) ora 
lineprinter is attached. 


1 - 3 CMTS cassette decks one thru three. 


HT High-speed paper tape. This refers to two 
devices - the photoreader and the high-speed 
punch. Output to HT refers to the punch; input 
refers to the photoreader. Bathners, -bDoOths,. or 

-neither can be present in. the system hardware 
configuration. 


LT Low-speed paper tape. This refers to the TTY 
reader and punch devices of the HP=inctertaced 
teleprinter. 

TY This refers to the keyboard/printer or keyboard/ 
CRT interfaced by means of the standard HP TTY 
interface. 


LP This refers to the standard HP-interfaced line- 
printer. It is an output device only. 


D1-D4 Logical units of drive D. The four floppy disk 
drives supported by FDOS are refered to by the. 
letters D, E, F, and G. The logical units of 
each are treated as physical devices. 

E1-E4 Logical units of drive E. | 

P1-F Logical units of drive F. 

G1-G4 Logical units of drive G. 

BK The Bit Bucket (an infinite write- ~only memory , 
a read produces End-of- File) 
The Extended Version of FDOS additionally recognizes and 


supports 3 


M6, M1 Mag Tape Units Zero and One. These are 
, the HP-interfaced, HP Magnetic Tape Units. 
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CR Card Reader. This is the HP-interfaced, 
HP Optical Mark Reader (and Punched Card 
Reader). This is an ASCII input only device. 


In order that application programs which are indepen- 
dent of the hardware configuration can be provided with. 
the system, a set of Functional Units is maintained. 

Each of these corresponds to a particular system func- 
tion. The actual physical device involved is determined 
by a table in the FDOS SIO Driver. The assignment of 
Physical Units to Functional Units is made at system 
generation time, and can be (temporarily) changed by the 
use of the AS command. The codes and corresponding | 
Functional Units recognized by the Exec are as follows: 


DP Data output unit (SIO 183B device). 

DI Data input unit (SIO 191B device). 

PL Program list unit (SIO 1082B device). 

PK Program keyboard unit (SIO 164B device). 

SC Seratch unit (1i.e., pass 1 QuePur. ‘of FORTRAN 
Compiler). : 

HL High-speed list unit Geer one or disk/tape 
file). 

BC -Bateh command Input unas < 

BM Batch message unit. 

AP Auxiliary Data output unit. 

AIT Auxiliary Data input unit. 

AH Auxiliary high-speed list unit. 

AL Auxiliary program list unit. 

AK Auxiliary program keyboard unit. 

AS Auxiliary scratch unit. 

CL Executive's console list unit. 

CK Executive's console keyboard unit. 


The FDOS I/O Driver supports sixteen other units. Users 
wishing to refer to these for use with their own applica- 
tion programs can use the codes S@, S1, .. ., S15. 
Physical and Functional devices are kept track of by 

the FDOS I/O Driver. It maintains two tables; the 
Functional Device Table (FDT) and the Physical Device 
Table (PDT). 


The Functional Device Table consists of 32 16-bit | 
entries, which correspond to the unit numbers 46 ouee 
77B. Each entry has the following format: 


Bits 65-@¢ Physical Unit (or another Functional 


Device). 
Bits 11-128 | Paging character PEC eta ee 


0 Use Null 

1 Use multiple Linefeeds 

2 Use Extra Paging character (set 
during sys-gen) | 

3 Use Formfeeds 
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Bits 14-12 Index to table of seven line counts for 

oe | page spacing. All devices have 66 lines 
per page, and do page spacing after 60 
lines. @ means no line counting. Bits 
14-18 not § means binary requests (negative 
word count) are treated as form-control 
commands. | 


The Physical Device Table consists of 16 8-bit entries, 
which correspond to the unit numbers 8 thru 17B. The 
disk Logical Units are handled separately (units 2@B 
thru 37B). The eight bits are interpreted as follows: 


Bit 6 Input capability. 
Bit 5 Output capability. 
Bit 4 Disk command capability. 
Bat: 3 Always zero 
Bit 2. Defines a non-file oriented device (viz, Deck 


Zero, High-speed SeDS: Low-speed Tape, TTY, 
Lineprinter). 
This arrangement corresponds to the. contents of the 
Command Requirement Table, indexed by driver commands. 


The FDOS I/O Driver provides a "sense" call for sensing 
the capabilities and identity of a Functional or Physical 
Device. The status words returned have the following 
format: | 


B Register 


Bits 4-6 Physical Unit. 
A Register om i 
Bit 14. Device has input capability. 
Bast 3 Device has output capability. 
| (Bits 14-13 both zero if device doesn't 
exist). 
Bit 2 Device accepts disk commands. 
Bit: 17 (Last) Functional Device does line count- 
| ing. If a zero, device accepts binary 
output commands; if a Physical Unit is 
specified in the call, this bit is zero, 
1.e., all Physical Devices which do out- 
put have binary rather than list capabi- © 
lity. Only Functional Devices can have 
: page formatting (line counting). 
Bit 12 Set if device has file-oriented (logical) 
hardware. 
Bits 6-4 Line counts Caron 14- 12 of FDT or command). 
Bits 3-2 Paging Character (from 11-18 of FDT or 
| command). 
Bits 6-2 are taken from the noted FDT Yoeations, 


except for three cases¢§ 
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1. If the device has no list capability (bit 11 
= §), then bits 6-2 are zero. 

2. IT£ the ultimate Physical Device is one which 
ignores functional line counts and page spacing 
characters (viz, Lineprinter, TTY, Deck Zero, 
Bucket), bits 6-4 are zero and bits 3-2 are 3 

- (Formfeed). | 
3. If the ultimate Physical Device is a disk 
logical unit, then bits 6-4 reflect the actual 
line counter, but bits 3-2 are 3 (Formfeed), 
since Formfeeds are always used for page 
spacing on disk logical units. © 


Hi Mee 
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IV.A. 


IV.B. 


SIO DRIVER PACKAGE DETAILS 


The SIO Driver package contains a combined driver capable of 
supporting the FDS, the cassette system, console device,.line 
printer, and high-speed paper tape equipment; a System Loader; 
and a Communication Region. The package also includes a con- 
figuration section to enable the user to adapt the package to 
a particular hardware arrangement and memory size. 


THE SYSTEM LOADER 


The System Loader is used to load other programs under Executive 
control, or for automatically reloading the Executive after the 
execution of another program. This latter function is accomp- 
lished by means of a transfer to location xX754@B, X7542B, or 
X7544B (see Section V.E.3). The locations X7534B-X7677B. must | 
not have been changed by the other program. These 144B locations 


‘constitute the only portion of the system which must remain 


resident in memory for continuous automatic operation. 


The function actually accomplished by the transfer to X754@B, X7542B, 
or X7544B is the automatic loading of one of the fixed address files © 
(SYS1, SYS2, and SYS3), thus bringing the system up from one of the 
three levels of restart (see Section V.B). If the SIO Driver 
package is to be used without the Executive, these functions must 
be modified, or appropriate programs must be placed in those files. 


The loader also has available another entry, ELOAD, described 
below. This entry allows the specification of the sector from 
which to start loading. As in the case of the other System 
Loader entries, the address of the first location loaded is 
immediately stored in location 3B, and JMP 3B,I is executed. 
upon completion of the load, unless another address is specified 
in STRTA (see below). : . . 


THE COMMUNICATION REGION 


The Communication Region is a set of locations referred to by 
other programs. They are gathered together into the area 
directly below the System Loader so that their actual octal 
addresses can be kept constant, despite any changes which may 
occur from time to time in the driver or loader programs. The 
following items make up the communication region: 
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LERR (X7537B). This cell has two uses. First, the System 
Loader uses it to indicate that there has been an error in. 
loading the Executive or some other program. In this case, 
LERR is set to -l, and a transfer is made to eee to reload 
the system via a "cold PERE E Ns 


The second use for LERR is for interpass loading. LERR is set 
to the address of the program name in core (three words contain- 
ing up to five valid ASCII characters, which are left~justified 
and zero-filled; this is preferably on the base page so that the 
Executive will not overlay it), and a transfer is made to X754@B 
to load.the Executive, which in turn loads the named program. 


BICHF (X7536B). This word specifies to the Executive whether 
control input is to come from the CK unit (on-line mode, 
BICHF = %) or from the BC unit (batch mode, BTCHF = -1l). 


STRTA (X7535B). This word is used to pass a starting address 
to the loader. If this is set to zero, the starting address - 
will be determined as explained above. Otherwise, the contents 
of STRTA will be used as the address to which to transfer after 
loading. fay 


JSYST (X7534B). This word contains a jump to X7546B. 


PARAM (X7524B - X7533B). These locations are used for passing 
parameters between programs. The Executive Run command passes 
up to seven parameters according to the following convention: 


PARAM: Contains the number of parameters passed. 
PARAM+n: Contains the value of the n-th parameter. 


The Executive's interpass loader does not modify the Peraneeey 
area. 


ELOAD (X7523B). This cell contains a jump to the generalized 
load entry point. A transfer to ELOAD with a sector address -_ 
in the A register will cause one file to be loaded starting 

at that sector. control will then pass to ene loaded program 
as described above (see eeRt als 
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AFLG (X7519B). This word is used by the SIO driver routines 
to indicate the type of binary data being processed. AFLG = 
191B for absolute binary; for relocatable binary AFLG = @. 
This must be set by the Carheng program. 


GSFLG (X7515B). This word is used by the Driver routines to 
control treatment of "group separator" (Form Feeds and the 
Extra. Paging Character). If GSFLG = %, then group seperators 
are not passed to the calling program; if GSFLG # @, then 

group seperators are treated the same as other characters. 
GSFLG is normally set to zero by the Executive before executing 
a Run command. 


P.FDT (X7521B). This cell contains the address of the functional 
device table. This is a table used by the driver in processing 
references to functional devices. 


P.PDT (X7529B). This cell contains the address of the physical 
device table. This table is used by the driver to store informa- 
tion about the availability and capabilities of the physical 
devices supported by the system. 


P.DIO (X7522B). This cell PRR ees address of DIO, the 
"system" entry to the FDOS I/O driver (see Section IV.C.1). 
P.CIO (X7512B). This word contains the address of the CIO. 
(Custom SIO) entry to the driver. The program may provide it-- 
self with SIO style calls (A = count, B = buffer, JSB, return to 
following location) and implicit commands (see Section IV.C.2c). 


P.XIO (X7517B). This cell contains the address of XIO, the 
"tailored" entry to the driver (see Section IV.C.2b). 


NLOGU (X7513B). This word contains. the negative of the number 
of Logical Units for FDOS (four per aEaNG 


NBUFS (X7514B). This word contains the negative of the number 
of buffers allocated to the FDS driver. NBUFS is established 
at Sys-Gen time (see Section V.F.14). 


- Data is stored on disk in fixed, 128-word blocks (sectors); this 

- is a basic hardware characteristic of the disk. From a soft- 
ware standpoint, data must be transmitted in record-oriented form; 
record length, however, is variable (usually approximately 36 or 
60 words - see Section II.C). Therefore, the FDS Driver uses no. 
relationship between records and sectors; rather, data are read 
from or written to disk in sector blocks, using core-memory buf- 
fers to parse out records or accumulate records. Operation of 
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the sector buffering is transparent to the user; if a record 
starts in one sector and continues to another, the next sector 
is managed automatically. 


The buffers are pooled and shared, and hueristically assigned . 
and used. The greater the number of buffers available for 

disk usage, the less overlap in the usage; therefore, the num- 
ber of disk accesses is decreased and thruput is increased. 

Since each buffer requires 129 words of core, a balance between 
the number of buffers and the amount of available memory must 

be determined for optimum operation; the minimum number of 
buffers is two, and the maximum is fourteen (see Section V.F.14). 


It should be noted that the assignment hueristics allow data to 
accumulate in the buffers. It is the purpose of the ZS: command 
of the Executive to clear out these buffers before switching 
disks so that sectors from the old disk, which are kept in core, 
are not interpreted as being from the new disk. = 


FDOS DRIVER CALLS 


1. The FDOS "system" driver entry is DIO. The calls to DIO 
have the following form: 


JSB P.DIO,I | 
DEF TABLE ADDRESS OF ARGUMENT TABLE 
(returns here with A & B set per IV.C.1d) 


P.DIO DEF X7522B,I POINTER IN COMM. REGION TO DIO 


TABLE ABS (command)SPECIFIES OPERATION AND DEVICE 
NUMB DEC (count) SAME AS SIO (A) SETTING FOR TRANSFERS. 
BUFF DEF Rcecee as one AS. SIO (B) SETTING FOR TRANSFERS 


la. The Command word specifies the operation in bits 9 thru 6; 
these are coded as follows: 


CODE OPERATION 

CO Skip to start of next file 
Gl Rewind : 

g2 Read a record 
 g3 Write a record 

G4. Write an End-of-—-File 

gS Name. Hookup hace 


g6 (Not used in FDOS- TE). 
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Q7 (reserved) 


1¢g (reserved) 

11 (reserved) 

12 Skip a record 
13 (not used) - 
414 (not used) 

15 Sense 

16 (not used) 

17 (not used) 


The Device is specified in bits 5 thru @ (see Table II-1l). Bits 
14 thru 1@ may be used to specify line counter/page character 
as in the Functional Device Table (FDT). Bit 15 must be zero. 


lb. The Count word specifies the number of operations or the 
amount of data: 


For skip operations, specifies the number of files 
or records to skip; use a positive count for ASCII — 
data, and a negative count for binary data. 


For Rewind, WEOF, and Sense operations, count is 
ignored. 


For transfer -operations, count specifies that length of 
data to be output or buffer available for input. If 
negative, it is minus the number of 16-bit words. If 
positive, it is the number of 8-bit ASCII characters. 


If ASCII is specified (positive A on call), records | 
are read up to the carriage return and line feed codes. 
These codes are also written at the end of each ASCII 
record output. They are not transferred to the buffer 
on input, and they are not counted in determining the © 
total number transferred on either input or output. If 
an odd number of characters is read, an extra space is 
supplied to fill out the last word. 


If binary is specified (negative A on call), data 
words are written from or read into ascending core 
addresses with the high order half-word correspond- 
ing to the first character input or output for that 
word. If an odd number of characters is read ina 
binary read, an extra zero is supplied. 


For Name Hookup, a code to specify the type of positioning; 


G.= disk file name, -1 = a numeric positioning, such as a 
cartridge track number (not used, for expansion only). 
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le. For transfer operations, the Address word specifies the address 
of the buffer. On Name Hookup, the Address specifies the address of 
the name (3 words) or the address of the number (1 word) . 


ld. On return from the DIO call, the contents of B contains the 
- physical device number See Table Ii- 1), and the contents of A is 
set as follows: 


‘1 for successful skip, rewind, write, 
write EOF, NAME HOOKUP 


(A) 


(A) = number of words or characters for 
successful read 


(A) = @ if file mark detected 


ERRORS: (A) = ~l if not ready 
(A) = -2 if write locked 
AK) = S374 end-of-tape white reading 
(A) = -4 if error status while writing 
(A) = -5 if eines status while reading 
(A) = -6 if end ere nape writing 
(A) = -7 de Pout error on FDS (wrong name in file) 
(A) = -8 if Aeneetetene device* 
(A) = ~9 if illegal device reference 
(A) = -1@ if nonexistent command 
“Non-existent device, physical geviee Age (A = 28; B = 17B), 


means FDT assignment loop. 


NOTE: If an error occurs and bit 15 of B is set, a drive related error 
has occured (not related to a logical unit such as disk full, format 
error, Or write protected) and bits 5-@ are coded as for a logical unit. 


2. Other FDOS Driver entries are SIO, XIO, and CIO. To use _ 
any of these entries, a JSB to it should be made with ane 
following register contents: . 


(A) 
(B) 


It 


‘count (see Section IV.C.1b) 


address of buffer (see Section IV.C.1c) 
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Successful return is made to the location following the JSB, with 
the following register settings: 


(A) = one for successful Skip, Rewind, Write, WEOF, 
or NAME HOOKUP operations; | 


(A) = zero if file mark detected; or 


(A) = number of words or characters transfered for 
read operation. 


(B) = physical device number used for operation (see 
| Table II-1). 


When these entries are used, error halts occur, as opposed to. 
status returns as in DIO. These error halts are: 


HLT 615 Device not ready. 
HLT 62B Device write locked. 
HLT 63B End of tape in read. 
HLT 64B Error during write. 

HLT 653 Error during ere 
HLT 66B End of tape during write. 
HLT 67B Disk format error. | 
HLT 708 _ Non-existent device. 
HLT 71B riiegat device reference. 
HLT 72B Non-existant eo 


When these halts occur, the registers are set as follows: 
(A) 


(B) = physical device used (see Table II-l1). If bit 15 is. 
set, then bits 2 and 3 define the drive used when 
accessing the disk directly (without using disk | 
logical units); bits 2 and 3 = OB define drive D, = 
1B define ‘E, = 2B define F, and = 3B define G. 


address of call 
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Pressing RUN will cause the command to a re-executed. Multiple 
record or file skips will re-execute the entire number, even if 
one or more has already been skipped. 


2a. Standard Hewlett-Packard software, which uses SIO driver 
calls, makes use of fixed locations in memory: 


1918 
1928 
1938 
124B 


1f5B 
1f6B 


1978 


-P.RE 


P. LW 


PMT 


Address of STO input entry 
Address of SIO list entry 
Address of SIO output ore 
Address of SIO keyboard entry 


First word address of available 
memory 


Last word address of available 
memory 


A flag used by HP MTS (not usable in FDOS) 


The Dicom combined SIO driver package sets all of these (except 
P.FW, which is normally set by individual programs) as Lollows 


(see entry names above): 


1f1B 
1pop 
138 
1948 
196B_ 


197B 


DEF SIO.I (uses DT) - 


DEF SIO.O (uses PL) 


DEF SIO.P (uses DP) 


DEF SIO.K (uses PK) 


DEF (last word before driver package) 


NOP (not usable - must be Q) 


The. SIO calls have implicit commands associated. with them; 
that is, teed or write on functional units. 


2b. The XIO calls allow explicit Sonmands: to be used, but are 
treated like SIO calls rather than DIO calls in regards to errors. 
The XIO calls are of the form: 
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LDA (count) 
LDB (address) 
JSB P.XIO,I 
ABS (command) 
(return) 


P.XIO DEF X7517B,I POINTER IN COMM, REGION TO XIO 
The command may be any valid command (see Section IV.C.la). 


2c. The CIO calls also allow explicit commands to be used, but 
are of a double subroutine level; the outer level uses implicit 
commands. Errors are treated in the SIO fashion as explained 
above. The CIO calls are of the form: 


LDA (count) 
LDB (address) 
JSB SIO. U 
(return) 


SIO.U NOP 
JSB P.CIO,I 
ABS (command) 


P,CIO DEF X7521B,I POINTER IN COMM. REGION TO CIO 


Note that no return is needed from the SIO.U routine; if an error 
halt occurs, then the A Register will contain the address of the 
JSB SIO.U. However, SIO.U must be exactly three words long (entry 
JSB, and command). ABS can be any legal command; (see Section 
IV.C.1a.) 


3. Utility commands exist within the combined driver. A command 

of minus one causes all the sector buffers to be cleared (see. 
Section IV.B); this is what occurs when the Executive's ZS command 
is used. This clearing of buffers should be accomplished prior to 
removing a cartridge from a drive, thus removing holdover sectors 
from the buffers. 


It should be noted that even though the address word (B in the 


SIO/XIO/CIO calls, or table entry three in DIO calls) is not used, 
it is evaluated, and therefore must not cause an indirect loop. 
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Other utility commands (negative value command word) exist in 
the combined driver; the user is referred to the listing of the 
driver for these. 


FDOS DRIVER OPERATIONS 


The action and idiosyncracies of the SEO DEO eae commands and 
Gevices are as follows: . 


1. Skip to start of file, octal Y+UNIT; skips past the number of 
End-of-File marks specified by the count. On file-oriented devices 
(disk or cassette) this is done by moving over files, but on paper 
tape type devices the data must be read to determine the End-of-File 
marks; therefore, the count must specify the mode (positive for 
ASCII, negative for binary). The sign of the count has no effect 

on a file oriented device. | — 


A count of zero results in no action being taken. If an error halt 
occurs, continuing will cause the entire number to be skipped 
again. If, on a paper tape type device, a multiple file skip is 
done and an intermediate End-of-File mark consists of over 20 nulls, 
then the first ten constitute the EOF and the subsequent group of 
ten nulls are ignored until a non-Null character is found. However, 
if the last file mark of the skip consists of over 20 nulls, the 
skip ends when ten are found, and a subsequent read (without manual 
intervention) will find ten more, resulting in an EOF (most programs 
ignore an initial EOF). A device must have input capabilities to 
do a skip; the Address parameter is ignored. | 


2. Rewind, octal 199+UNIT; on a file-oriented device (disk or 
cassette), positions to in front of file #1. On paper tape type 
devices, executes a HLT 6@B (even if a DIO call) to allow manual 
intervention before continuing.» 


A device must have input or output capabilities to do’a rewind. On 
disk, even if no files are in the LUD, there is no End-of-Tape indi- 
cation Cuntil some forward movement is given). The count and the. 
address parameters are ignored. 


3. Read a record, octal 29M+UNIT; reads a record in the specified 
mode into the specified buffer of a specified length, one character 
at a time. The Address word may be indirect. The count must be 
positive to indicate the number of ASCII characters, or negative to 
indicate the number of binary words. Characters are interpreted as 
they are read. In binary, only the first character, as the record 
length; in ASCII, all characters as to meaning (Nulls ignored, 
Rubout deletes line, Return ignored, Linefeed ends record, CNTRL/H 
deletes preceeding character of line, Extra paging character con- 
verts to Formfeed, Formfeeds ignored or passed according to GSFLG) . 


If the buffer address is Darou hen the count is ignored and no 


data is transmitted to the user (this is a skip one record); other- 
wise, if the count is zero, no action takes place and A is returned 
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as 1. Reading continues until a record containing some data is 
found. If a record is larger than the specified buffer length, 
then the extra characters are not transmitted and input continues 
to the end of the record (to leave the device properly positioned 
for the next record). Finding a physical EOF (on file-oriented 
devices) or finding ten Nulls at the start of a read operation is 
interpreted as EOF (file oriented devices are always left past the 
physical EOF). If an odd number of characters is read in a record, 
the last word of the buffer is filled with a zero if binary, or a 
space if ASCII (although the space is not included in the count 
returned). In ASCII, if a Linefeed is not preceded by a Return 
or a Linefeed, then a Return is echoed if appropriate for the 
device (i.e., on TTY, and Deck Zero). A device must have input 
capabilities to do a read. | . 


4, Write a record, octal 3QQ+UNIT; transfers the specified number 

' of words or characters from the specified address in the specified 
mode, or does a format control to. the device. In binary transfers, . 
the count is the negative number of words, and those words are trans- 
ferred with no processing, but some (physical device. dependent) 
processing is done at the end of. the record - paper tape type have > 
four Nulls following, cassette has a physical end-of-record 

following which signifies logical end-of-record on binary input, 

disk has no processing (and records could theoretically be 
concatenated). 


In ASCII transfers, the count is the positive number of characters, 
and these characters are transferred (except for nulls and except 

for the last character if it is a backarrow). A Return and Linefeed . 
are output unless the last character of the record is a backarrow. 

If the Return and Linefeed are output and a line count is being kept 
(and the count goes to 6%) then the specified paging is done for 

the device and the line counter is reset. 


In format aontrol. a zero count always means output a Return and a 
Linefeed. If the device is a list-capable unit, then the negative 
count means formatting rather than binary. A minus one means top 

of form. All other negative values are ignored. Format control oe 
ignores the address parameter. A device must have output capability 
to do a write. 


5. Write an End-of-File, octal 4@@+UNIT; on a file-oriented device, 
a physical End-of-File is written and, on disk, the unit is positioned 
to the begining of the next file. © On the lineprinter, two pages are. 
ejected. On paper tape type devices, if it is a list-capable device, 
a Formfeed, a Rubout, and a Linefeed are output followed by, or if. 

a binary device, only, 22 nulls (to allow for over ten nulls and 
tear-off space on Low-speed Tape, or to allow time to tear off the 
page on TTYs), and, if High-speed Tape, 19@ nulls for leader/ 
trailer. A device must have output capabilities to do a WEOF. 


6. Name Hookup, octal 5%@+UNIT; passes to disk logical unit a 
name. The count parameter must be zero (a flag) and the address 
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points to the name (up to five valid ASCII characters, left- 
justified and zero filled in three words). The logical unit 
temporarily remembers the name, and, with the next access, pro- 
ceeds with that file (randomly accessed via the Disk Directory) 
as if it had been in the LUD at that point. The name is not | 
remembered after the first motion access to that logical unit, > 
but the logical unit will be in the file until it leaves for 
some reason (Rewind, Skip, WEOF, or EOF read, etc.). If the 
logical unit leaves the logical unit at the EOF (rather than a 
Rewind) it will be positioned as it was before the Name Hookup, 
unless it was in a file, in which case it will be at the begin-. 
ning of the following file. 


The ame Hookup command provides for a number to be passed (count 
= -1, address points to number) for count-selection type purposes 
in other type devices. A device must shave disk command capabi-- 
lities to do a Name Hookup. 


7. Verify a record, octal 640+unit ; has been ELIMINATED due to 
its inaccuracies - since it would not properly handle ASCII 
records containing. Rubouts or CTRL/H (as the buffer and Success/— 


Fail were already affected by the deleted characters), and since 


it did not take into account the lengths of the two records. 
This command now produces a. nonexistent command error (HLT 72B 
or A = -16). 


This does not affect the Executive's verify command (VE), nor 
did the Executive's command have the aforementioned problems. 


8. Skip record, octal 12¢0+unit; the specified number of records 
are read (under the same conditions as read) in the specified 
mode, but no data is passed to the user. 


9. Sense device, octal 15dd+units the status words returned as 
defined in Section III-H. 


SPECIAL CONSIDERATIONS OF THE EXTENDED VERSION ADDITIONAL DEVICES 


1. Card Reader; The card reader will not accept requests for 
binary input or any type of write; such a request will produce 
an illegal device reference error (HLT 71B or A = -9). ASCII 
is generated from the Hollerith (829) of the cards using the 
relationships of the original HP SIO Driver, with the addition 
of the Formfeed and Rubout characters, and End-of-File cards. 
A linefeed (end of ASCII record) is automatically generated at 
the end of a card, and trailing blanks are ignored (including 
an entirely blank card). 


The special translations produced (non-industry standard) are: 


ASCII G29 Key 

[= (shift/K). ae Cent Mark 

—)] (shift/M) Not Sign 

* (shift/N) | Vertical Bar 
€@ (shift/0) Underline. 


N (shift/L): | "g-g-2" 
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Formfeed . | “Multipunch 12-4-8-9 
Rubout | Multipunch 12-7-9 


End-of-File Card /* in Columns 1 and 2 


The Formfeed character was added to allow formatting a deck 
for listing with the Executive LIST command, and should be on 
a card by itself, and in column one (this is an expectation of 
the Executive, not a requirement of the driver). The Rubout 
character was added to allow a card to be "hidden" in a deck - 
physically present but logically ignored. 


2. Magnetic Tape, in ASCII mode. Logically, the MagTape in. 
ASCII mode behaves like any other device; to do this at the 
speed of the tape requires buffering the processing. A disk 
buffer is "borrowed" and characters are accumulated therein and 
written as a block or read as a block and extracted therefrom. 
All of this is transparent to the user under FDOS using tapes 
generated under FDOS or MTOS. For a more detailed explanation, 
including handling of eRe records generated under HP MTOS, see 
Appendix H. 


3. Magnetic Tape, in BINARY mode. Due to the way MagTape is/was 
processed under MTOS, and since MagTape is frequently used for 
transferring data from one computer to another, the processing of . 
MagTape binary records is different from normal processing of 
binary records from other devices. A binary Skip Record skips 
physical tape records, without reading them and ignoring all 

error status except End-of-File and End-of-Tape (thus bad records 
can be skipped); a binary Read or Write transfers directly 

between user core and the MagTape one physical record of (Cup to) 
the length specified, as words, and without any logical processing 
(such as word length in the high byte of word one, or leading nulls 
being ignored and/or counted to cause EOF), this is to allow 
reading or writing of large blocked data from/for other computers. 
However, again things are handled in such a way that these consi- 
derations do not affect the user when dealing with tapes generated 
by normal program under FDOS or MTOS. 
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FDOS CONFIGURATION 


The. FDOS software is shipped in both a "standard@" configuration 


and a "skeleton" configuration. Thus, the user can configure. 


his hardware per the "standard" software configuration and get 
the FDOS "on-the-air" immediately; or the user can use the > 
"skeleton" portion and tailor the software for the memory Size, 
interface channel assignments, and functional unit assignments 
that match his specific requirements. 


FDOS "STANDARD" CONFIGURATION — 


The "standard" software configuration shipped can be installed 
per the "Installation of Software" appendix of this manual. 
This software configuration is as follows: 


Memory gigs - 12K 


Channel Assignments - | 

* 19B = FDS Data channel 

* 11B = FDS Control Channel 

-* 12B = Console Device Interface ener: (HP- interfaced 

teleprinter) 

* 13B = Photoreader Interface Braver 

* 14B = Cassette System Interface channel 

* The Line Printer (if available) -is attached to severe? 
Device zero (cassette sae eee zero"). 


Functional Unit Assignments — 
* Disk drive D as the “system library device" used by 
the Bootloader, System Loader, and the various system 
processors 
* El as the SIO Input Unit (DI) used ae the Executive 
default conditions (when applicable) and the various 
system processors 
* E2 as the SIO Output Unit (DP) used by the Executive | 
default conditions (when applicable) and the various 
- system processors 
* E3 as the High Speed List Unit (HL) need i he various 
. system processors . 
* E4 as the scratch area (SC) used by the FORTRAN Compiler 
as temporary storage for the intermediate file (between 
pass one and two) | 
* All keyboard units (CK, PK, aha aK) Sie nGned: eo the 
HP-interfaced Teletype (TY) | 
* All low-speed list units (CL, PL, AL, and BM) assigned 
to the HP-interfaced Teletype (TY) | 


Auxiliary Input (AI) assigned to the photoreader 
Auxiliary Output (AP) assigned to cassette deck one 
Auxiliary Scratch (AS) assigned to cassette deck two 
Auxiliary High-speed List assigned to the cassette 
system "deck zero" (lineprinter) 

Batch Command assigned to D2 > 

D4 as the library device for the Relocatable Library 
used by the Absolute BCS file ! 


+ + % 


+ 


FDOS INITIALIZATION AND LOADERS 


The FDOS software makes available a number of different levels 


of restarts and initializations in order to accomodate the 
varying needs of users and software packages. The FDOS © 
software is supplied on a "skeleton disk" which contains seven. 
files (designed specifically to facilitate startup procedures) 
plus the other FDOS program files. The seven specific files 
ae | rian | ; 7 
The unconfigured Bootloader 

The configured System Loader 

The "Skeleton" file (SYS@) _ 

The "cold start" file (SYS1) come tshae tet 

The “warm start" file (SYS2) *™ %”Y”"” | 

The. "Executive" file (SYS3) 

The "System Map" file (SYSM) 


ee te eH H 


1... The unconfigured Bootloader is designed to be loaded by. 


the Keyed-In Loader (see Section V.C). Once the unconfigured 
Bootloader has been loaded, it can be configured for channel 
assignments and memory size, and the configured Bootloader 
moved to the protected area of memory (see Section V.D). 


2. The "Skeleton" file (SYS%) contains the unconfigured System 
Loader, unconfigured SIO Driver package, unconfigured Exec- 
utive, and the System Generator. Special precautions are 
taken in the FDOS software to protect this file: (see Section 
VI.F.2); thus, it is always available to the user for use 
in building a new FDOS software configuration. 


3. The configured System Loader resides in sector zero of 
the disk, and is normally loaded via the configured Boot- 
loader. The System Loader is the "core resident" portion 
of FDOS. On the "skeleton disk" shipped from the factory, 
the System Loader is configured per Section V.A; when the 
configuration (see Section V.F) is performed, a new System 
Loader is written in sector zero. — | : 


The "System Map" file (SYSM) contains a listing of all 
peripheral device channel assignments, all functional unit 
assignments, and other system configuration details. 

This file can be printed on the Teletype with the Sore ne 
command pene (see Section VI.F. 2): 


SE;TQ D1,SYSM;LI D1,CL 


Section V.G shows a printout of SYSM for the "standard" 
software configuration. The Functional Unit assignment 
portion of the System Map can be printed geteeely with 

the List AL1 units (LA) command. 


The three remaining files (SYS1, SYS2, and SYS3) contain 
the configured (per Section V.A) FDOS software system; 
when the system generation is performed, a new software 
system is written into these files. Special precautions 
(see Section VI.F.2) are also taken here, so the System 
Generator is the only package. that can normally write in 
these files. 


Track zero of all disks is reserved for system control 
information (directories, etc.); the various "system" files 
Start and/or reside on track zero. This track is allocated | 
as follows: ! 
Sector @ Configured System Loader 
Sector 1 Disk Directory 
Sector. 3 Unconfigured Bootloader 
Sector 4 Logical Unit Directory, unit 4 
Sector 5 Logical Unit Directory, unit 1 
Sector 6 Logical Unit Directory, unit 2 
Sector 7 Logical Unit Directory, unit 3 
Sector 13 Starting Sector of the "System Map” 
| file (SYSM) | 
Sector 14 Starting sector of the "Skeleton" 
file (SYSQ@) | | : | 
Sector 15 Starting sector of the "Cold Start" 
file (SYS1) i fees : 
Sector 16 Starting sector of the "Warm Start" 
file (SY¥S2) _ 
Sector 17 Starting sector of the "Executive" 
file (SYS3) . : 
All other sectors of track zero (sectors 2,10,11, and 12) 
are reserved for expansion. The remaining disk area 
(tracks one through 64) is used by the Saeed FDOS pro- 
grams, or is available to the user. 


ee, 


FDOS KEYED-IN LOADER 


The FDOS Keyed-In Loader is a program used to load the uncon- 


‘£Ligured Bootloader from sector three of disk D. 
Loader is designed to be as short as possible, 


The Keyed-In 
Since it is 


intended to be entered from:-the front panel of the computer. 


Since the unconfigured Bootloader is in a special format, it 


must be loaded with the Keyed-In Loader; the Keyed-In Loader. 
cannot be used for loading any other file from disk. | 


To commence the configuration process, enter the Keyed-In ~ 
Loader shown below (refer to "A Pocket Guide to the 2100 |. 

Computer" or to "A Pocket Guide to Hewlett-Packard Computers") ; 
then configure the remainder of FDOS per Sections V.D and V.E. 


a ee 
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FDOS KEYED-IN LOADER 


THIS PROGRAM LOADS THE UNCONFIGURED BOOTLOADER INTO MEMORY 


(STARTING AT LOCATION $7699B) AND HANGS. 


WHEN THE PROGRAM 


IS STARTED, THE DISK WILL CLICK; THE UNCONFIGURED BOOT- 
LOADER IS IN CORE 'INSTANTLY'. PRESS HALT. NOW CONFIGURE 


B299e 


G2GGH 1931pCto START 


P29P1 


G29G2 


$2993 
29H 


P2B95 


P2PPe 
G29Q7 
$2919 
$2911 


— G2912 


e+ Ft & F 


02913 


2014 
B2G15 


pe Is 


cc Is 


G62G14 
66915 
1926cc (5 
TPsiccys. .- 
192 3Dc /° LOOP 
B260G5 — 
1925pc 10 
1837pDc /° 
17PPP1 

PPoP pA 
B20995 
020083 READ 
GZ7ELH CORE 


ORG 


CLF 


THE BOOTLOADER PER SECTION V.D. 


2005 


DAT 
READ 
CORE 
CMD 


CMD,C. 


DAT 
*-] 
DAT 
DAT,C 
B,I 


LOOP’ 
29693 
7620 


MAKE SURE FLAG IS CLEAR 
READ COMMAND 
ADDR TO LOAD INTO 
SEND — a ; 

THE COMMAND 
WAIT FOR 

DATA FLAG 
INPUT A WORD 
ACKNOWLEDGE 
STORE WORD | aca 
BUMP STORAGE POINTER 
GET ANOTHER WORD © | 
DISK D, SECTOR THREE > 


THE DATA CHANNEL (NORMALLY 19B) 
THE CONTROL CHANNEL 


FDOS BOOTLOADER CONFIGURATION 


The FDOS Bootloader is designed to load the configured System 


Loader from sector zero of disk D; it has a second entry that 
can be used to load any absolute file from disk D whose initial 
sector address is contained in the Switch Register. The Boot- 
loader is supplied on the “skeleton disk" in sector three; 

it is not configured. 


1. To configure the Bootloader, enter the Keyed- -~In Loader 
(see Section V.C) and place the "skeleton disk" in drive | 
D. Preset the computer, then start the Keyed-In Loader  — 
at G2G9GB to load the unconfigured Bootloader and its 
configurator. Halt the computer, then restart it at 
@7690B; the configurator Progen will come to a series 
of halts: 
HLT | 74B Enter the see: data channel in the 
Switch Register Naas ae 12B) and 
press RUN. 


HLT 75B Enter the disk control channel in the 
Switch Register (normally the lowest 
priority channel, although it can 
be of higher priority than any 
asynchronous device) and press RUN. 


HLT 76B Enter the memory size mask (X7799B) 
: in the Switch Register, enable the 
loader area,. and press RUN. The | 
Bootloader will be configured and 
moved to X77@@B, i.e., the protected 
area of memory. Use X = 1 for 8K, 
2 £0r 12K, 3 for 16K, etc. — 


HLT | ae: Sentiaueation COND EECs protect. the 
loader area. 


De: The configured Bootloader has two entry points: 


X77G9B Load a file from disk D, sector Zero; 
this is normally the configured 
System Loader. 


X7791B Load a file from disk D whose initial 
| | sector address is contained in. the 
Switch Register. (If using a 2114, 

the LOADER ENABLE switch on the inside 

of the front panel must be in the ON | 

- position to start at location 17791B.) 


After execution at either of these entry points, the Boot- 
loader will halt with the P Register equal to 2B; if the 
configured System Loader was the file loaded, it can be 
executed by just pressing RUN. This is possible, since 

the System Loader (as it is being loaded by the Bootloader) _ 
sets location 2B to a jump indirect through 3B, and sets 
location 3B to X7544B (the "cold start" entry point); upon 
successful loading, the Bootloader halts with the P Register 
set to 2B. Since most absolute program files also set 
locations 2B and 3B in this manner, this feature can be used: — 
to load and execute those files. | 


FDOS SYSTEM LOADER 


The System Loader is intended to remain in memory at all times. 
When not resident in memory, it can be loaded by the protected 
Bootloader. The System Loader has three entry points: | 


X754GB Standard Exec reload; load the file starting 
at sector 17B. This entry is used by the 
ASMB, EDIT, CROS, etc., programs. It leaves 
the SIO area, Communications Region, Logical 
Unit Parameter Tables, and buffer status intact. 


X7542B Load the file starting at sector 16B, the 
"Warm start"; the SIO and Communications 
Region are reloaded, and a transfer to X754@B 
is made to reload the Exec. The Logical 
Unit Parameter Tables and buffer status tables 
are left intact. This is intended to restore _ 
the original SIO configuration after a 
temporary reconfiguration. 


X7544B Load the file starting at sector ‘15B, the 
"Cold start"; this is intended to be used when > 
the contents of memory can no longer be counted 
on, such as after a program which does not 
preserve the SIO area has been run. This 
start must be used if the system ever "crashes". 
This start initializes the Logical Unit 
Parameter Tables and the buffer status tables, 
and transfers to X7542B for a "warm start". 


On the "skeleton disk" shipped from the factory, the System 
Loader is configured per Section V.A.; when the configuration 
(see Section V.F) is performed, a new System Loader is written 
in sector zero. 


FDOS "SKELETON" CONFIGURATION 


The "skeleton" file (SYS%) contains an interactive System 


Generator section, the unconfigured SIO Driver, the uncon- 


figured System Loader, and the unconfigured Executive. When 
SYS@ has been loaded and executed, the user can tailor FDOS 
to a particular hardware configuration, memory size, unit 
assignment, etc. This is accomplished by typing responses 
to questions asked by the System Generator; after the con- 
figuration parameters have been entered and verified,the 
System Generator (optionally) writes a configured FDOS 
software system into SYS1, SYS2, SYS3, and SYSM of disk D. 
It should be noted that this System Generator can be used to 
prepare an FDOS disk for a computer system with a different 
hardware configuration from the one it is being run on; the 
only restrictions are that the current system has at least 


as much memory as the target system, that the disk data and. 
control channels are the. same on both systems, and that the 


console device has the same channel number on both systems. 


Following is the configuration procedure: 

1. Bootload SYS using the X77@1 entry of the Bootloader 

with the Switch Register set to 14B. To execute the file after 
such a load, press RUN; the computer will execute a HLT 5@B. 


2. Set the Switch Register to the channel number of the console 
device (functional units CK and CL); if the console device 
is interfaced thru the cassette system deck zero, set bit 15. 
also. Press RUN. | ee eee A | 7 
3. The program types 

SYSTEM ID: 


requesting up to sixty characters of ID information to be used 
to label the resultant configured disk. This ID information 
will be written in the System Map (SYSM) file if "write. 
system to disk" is specified later on in this system gener- 
ation procedure. . ) . 


NOTE: Responses to questions are terminated by Carriage 
Return-Line Feed. If an error is made in answering 

the questions in Step 4 and beyond, the System Generator 
can be restarted at Step 3 by typing "ER". The valid 
responses are "NO" to indicate that the device is not 
available, a two-digit octal number defining the device's 
channel number, or responses defined in the descriptions 
below. - 


4. If bit 15 was not set in Step 2 above, the program types 
TELETYPE CHANNEL: CC 


where "CC" is the two digit octal number that was entered in 
the Switch Register in Step 2 to define the HP-interfaced , 
Teletype channel. If an HP-interfaced Teletype was not defined 
in Step 2 (bit 15 set), the program types | 


TELETYPE CHANNEL? 


requesting the HP-interfaced Teletype channel number. 
Reply appropriately. If "NO" is typed, the program proceeds to 
STEP qs 


5. The program types 
USES PAGING OPTION? 


requesting the option to be used to format printed pages on 
this Functional Unit (CL). . Respond by typing "L" for Linefeed, 
"FP" for Formfeed, "N" for no page spacing, or "X" for the Extra 
Paging Character (see step 18). 


sa. The program types. | 
BACKSPACES ON CTRL/H? 


wanting to know whether to echo the deleted character after 

a CTRL/H (delete character) input from this device. If the 
device interprets (generally true only of. CRT): “the CTRL/H 

as a Backspace by repositioning its carriage or curser to the 
left (€ such as HP-264@A terminal ) then the echoed character 
would only overwrite the last visible character typed and appear 
to have no or the wrong effect. So if the device does so. 
‘reposition, answer YES and the cursor/carriage position will 
record what has been deleted; if not, answer NO and the charac- 
ters will be echoed to record current line position. (The 
device is originally assembled equivalent to YES) 


6. The program types 
HAS LOW SPEED TAPE? 
thus asking if the HP-interfaced Teletype is to be used for 
paper tape input or output. Reply by typing "YES" ee INO". 
If "YES" is typed, the program types . 
PUNCHING AND PRINTING SEPARATE? 


thus asking if the HP-interfaced Teletype is an ASR33 or ASR35 , 
Type "NO" if ASR33; type "YES" is ASR35. | 


If an ASR33 is defined, then under normal FDOS operation the 
computer will halt (HLT 56) before outputting to the ASR33 
paper tape punch to allow the operator. to turn on the punch; | 
when punching is complete, the computer will halt (HLT 55) to 
allow the operator to turn the punch off. 
7. The program types | 

HIGH SPEED PUNCH CHANNEL? 


requesting the. re speed paper tape punch channel number. 
Reply appropriately. 


8. The program types 
HIGH SPEED READER CHANNEL? 


requesting the channel number of the een eases 
Reply SPE CORE satel ys 


9. The program types | 
LINE PRINTER CHANNEL? 


requesting the line printer channel number. 
Reply pp yropE atc y 


9a. The program types 
STANDARD CONTROL (2767)? 


asking if the device is an HP-2767 (data products) printer or 
uses the same control characters and features - no carriage | 
return, ASCII linefeed and formfeed (@12 and @14), 132 charac- 
ter carriage, built-in DOLTOM- OFT form sensing, and formfeed to > 
top-of-form. 

Reply appropriately; if the answer is YES, the program proceeds 
to step 10. NOTE: All control characters have the high bit 
set; this is transparent to the user. 


9b. The program types 
CARRIAGE RETURN? 


“requesting the low 8 bits (in octal) of the carriage return 
character, if one is needed; if one is not needed, reply "NO". 


9c. The program types 
LINE FEED? 


requesting the low 8 bits (in octal) of the nee -eject 
character. This character is required. 


9d. The program types 
FORM FEED? 

same as 9b. 

9e. The program types 
“LINE WIDTH? 


asking the maximum number of characters to be printed on one 
line (all extra are ignored). 
Reply appropriately. 


9f. The program types 
SOFTWARE LINE COUNT? 


asking whether to use a line Souaree (#18) for page spacing. 
If the device has hardware bottom-of-form sensing and finds 
top-of-form by a Formfeed answer "NO", else answer "YES". 


as The program types 
PAGING OPTION? 


The response is the same as Seep 5. (NOTE - Formfeed in 
this case refers to the answer. to Sd, not the normal 214B 
character). 


10. If bit 15 was set in Step 2, the program types 


CMTS CHANNEL: CC 
DECK ZERO EXISTS 

HAS INPUT CAPABILITY. 
USES PAGING OPTION? 


where CC is the channel number defined in Step 2. The response 
to the paging option question is the same as in Step 5. 


10a. The program types” 
~BACKSPACE ON CTRL/H? 


wanting to know whether to echo the deleted character after 

a CTRL/H (delete character) input from this device. If the 
device interprets (generally true only of CRT) the CTRL/H 

as a Backspace by repositioning its carriage or curser to the. 
left (such as HP-2646A terminal) then the echoed character 

would only overwrite the last visible character typed and appear 
to have no or the wrong effect. So if the device does so repo- 
Sition, answer YES and the cursor/carriage position will record 
what has been deleted; if not, answer NO and the characters will 
be echoed to record current line position. (The device is. 
originally assembled equivalent to YES). | 
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11. If bit 15 was not set in Step 2, the program types 
CMTS CHANNEL? 


requesting the cassette system channel number. If "NO" is 
typed, the program proceeds to Step 12. If "YES", the program 
types. 

NOTE: that the cassette system must be turned on as the program 
will test the revision type by issueing a command to the unit. 


DECK ZERO EXISTS? 


asking if a.device (TTY, CRT, line printer, etc.) is inter- 
faced to the computer via deck. Zero. Leo MYES"” 26° “typed. 
the program types 


HAS INPUT CAPABILITY? 


asking if the device has a keyboard on it. 
Reply appropriately. The program types 


USES PAGING OPTION? 


The response to the paging Opn? question is the same as 
in Step 5. 


lla. The program types 
| BACKSPACE ON CTRL/H? - 


wanting to know whether to echo the deleted character after 

a CTRL/H (delete character) input from this device. If the 
device interprets (generally true only of CRT) the CTRL/H 

as a Backspace by repositioning its carriage or curser to the 
left (such as HP-2646A terminal) then the echoed character 

would only overwrite the last visible character typed and appear 
to have no or the wrong effect. So if the device does so repo- 
sition, answer YES and the cursor/carriage position will record 
what has been deleted; if not, answer NO and the characters will 
be echoed to record current line position. (The device is 
originally assembled equivalent to. YES). 


12. The program types 
| FLOPPY DISK DATA CHANNEL? 


requesting the FDS data card onannet number. Since this 
must be defined, a "NO" response causes the quest on to be 


re- ~asked. 


13. The program types 
FLOPPY DISK CONTROL CHANNEL? 


requesting the FDS control card channel number. A "NO" causes 
the question to be re-asked. 
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14. The program types 

NUMBER OF BUFFERS? 
Reply appropriately (see Section IV.B). For optimum operation 
in an 8K system, three buffers are recommended; in 12K or 
larger systems, four buffers are recommended. | 
15. The program types | 

NUMBER OF DRIVES? 


Reply appropriately (one to four), depending on how many 
drives are implemented in the FDS. 


16. The program types 
DISPLAY DISK. COMMANDS? 
inquiring as to whether disk commands are to be displayed in 
the Switch Register during FDOS SIO operation; reply appropri-— 
ately. Commands are not displayed during BCS operation. 
X-1. If the Extended Version, the program types 
CARD READER? 


requesting the card reader channel number. 
Reply appropriately. 


X-2. If the Extended Version, the program types 
‘MAG TAPE DATA CHANNEL? — 723 


requesting the mag tape data channel number. Te. NO". 
the program proceeds to Step 17. 


X-3. If the Extended Version, the program types’ 
| MAG TAPE CONTROL CHANNEL? | 


pequces ine the mag tape control channel number. A "NO" 
causes step X-2 to be re-asked. 


X-4, If the Extended Version, the program types 
TWO DRIVES? 


requesting whether one (unit $) or two (units @ and 1) 
are available. Reply appropriately. 


17. The program types. 


FUNCTIONAL UNIT ASSIGNMENT: 
‘ss | 


At this point the operator may change the physical unit vs. 
functional unit assignment for a particular configuration of 
hardware. Until some experience has been gained, it is 
recommended that the user respond with only "/E", to cause 

the standard assignments that have been assembled into sys-gen 
to be used. To change the Functional vs. Physical: Unit assign- 
ments, use the format FU, PU, LC, PC (see Section II.B). : 
Typing "A?" will list the entire FDT; "/E" terminates and s 
moves on to the next step. Restarting without reloading (NER" 
input) does not restore the FDT. © 


18. The program types 

EXTRA PAGING CHARACTER? 
Unless the system has a list device that is capable of responding — 
to a page-spacing character other than Linefeed or Formfeed (such 
as Vertical Tab), it is sufficient to respond "NO". Otherwise, 
respond with a two-digit octal number representing the ASCII 
character desired. 
19. The program types 

CORE SIZE (IN K)? 
Reply appropriately. 
20. The program types 

WRITE SYSTEM TO DISK? 
Reply "YES" if it is desired to write this newly configured 
system to disk (in SYS1, SYS2, SYS3, & SYSM) later on in this 
program. 
21. If "YES" was typed in Step 20, the program types 

FORMAT DISK? 


- inguiring as to whether a Format Disk command to drive D is 
desired. Type "YES" if there is a virgin disk in drive D. 


22. The program types 
CONFIGURATION MAP? 
Reply "YES" if it is desired to have one printed on the console 


device at this time; if "YES,unit" is typed, the map will be 
written to the specified unit. 


23. The program types 
OKAY AS IS? 


If the configuration is as desired, type "YES". At this point 

the unused portion of DIO (drivers for non-existent peripherals) | 
is released and the system is configured in core. If the pro- 

gram was directed to write the system in step 20, SYS1, SYS2 5 
SYS3, SYSM, and the configured System Loader are written onto 
Disk D (see Section V.B.), all of memory below X7534B is set 

“to zero, and a "cold start" is made via a transfer to X7T54H4UB; 

if the program was not directed to write the system, a transfer 
is made to the Executive. If the configuration is not as desired, 

type MoM. . ’ ? ‘ 


_& 


24. The program types 
START OVER? 


if "YES" is typed, the program goes back to the "SYSTEM ID" 
question of step 33; if "NO" is typed, the program goes back 
to step 23. ca = 


25. The following error halts are applicable to the System 
Generator: 7 | 


HLT 3B The process of allocating buffer space has 
| _ caused the SIO package to require more than 
4K, which is the legal limit (due to locating 


the communications region). This error is fatal 
and irrecoverable, continuation will repeat 
HLT 3@B. 


(NOTE - It is possible for this. problem to cause 
a HLT 32B in an 8K system). Reload SYS@ and 
restart the system generator, and request fewer 
buffers. 


HLT 31B The value stored at the address displayed in 
the Switch Register did not hold (either non- 
existent memory, faulty memory, unattached or 
unplugged memory, etc.). Correct condition 
and press RUN, or reload SYS@ and restart the’ | 
system generator. 


HLT 32B The process of moving the system has caused 
an over-lap of sections of relocatable code. 
This is a program safety check to insure the 
resultant system will fit in the available 
memory; it is fatal and irrecoverable. 
Continuation will repeat HLT 32B. Reload SYS@ 
and restart system generator. 


HLT 47B The processing of devices has caused an 
impossible situation. Press RUN to restart 
the configurator. Theoretically, this can not 
happen! . | 


26. It is not necessary that the configurator write out the 

new system on the "skeleton" disk shipped from the factory; in 
fact, it is best if it does NOT, since this disk should always 
remain write-protected and used as the "master". The "skeleton" 
disk could have been replaced by any (virgin) disk after SYS@ 
was loaded from it. However, if a freshly formatted disk is 


used to write the just-configured system onto, SYS#@ (sector 14B) — 


will be an empty file, but sector 14B will be preserved for the 
initial sector of SYS@. This means that the "skeleton" file > 
(SYS6) does not get written during the configuration process; 
however, the unconfigured Bootloader does get written into sec- | 
tor three. The SYS@ file could be copied from the "master" 
‘disk after the configuration process if it were desired to. 

have it on the "working" disks. The copying of SYS#@ (plus all 
other files on the "master" disk) can be accomplished easily 
with the CODSK batch file; see the INSTALLATION OF SOFTWARE 
Appendix of this manual. : | 


SAMPLE SYSTEM GENERATION PRINTOUT 


SYSTEM IDs» — -, 
SAMPLE SYSTEM GENERATION PRINTOUT . 


- TELETYPE CHANNEL: 12 

USES PAGING OPTION? NO 

BACKSPACES ON CTRL/H?. YES 
HAS LOW SPEED TAPE? YES | 
PUNCHING AND PRINTING SEPARATE? NO _ 


HIGH SPEED PUNCH CHANNEL? 15 
HIGH SPEED READER CHANNEL? 13 
LINE PRINTER CHANNEL? NO 


CMTS CHANNEL? 14 
DECK ZERO EXISTS? YES 
HAS INPUT CAPABILITY? YES 
USES PAGING OPTION? NO. 
BACKSPACES ON CTRL/H? YES 


FLOPPY DISK DATA CHANNEL? 16 


FLOPPY DISK CONTROL CHANNEL? 11 
NUMBER OF BUFFERS? 4 
NUMBER OF DRIVES? 3 
DISPLAY DISK COMMANDS? YES 


<<FUNCTIONAL UNIT ASSIGNMENTS: >> 
2 /E 


EXTRA PAGING CHARACTER? NO 
CORE SIZE CIN K)? 12 


WRITE SYSTEM TO DISK? YES 
FORMAT DISK? YES 


CONFIGURATION MAP? YES 


SYSTEM IDs | SAMPLE SYSTEM GENERATION PRINTOUT 


CMTS CHANNEL: 14 
DECK ZERO EXISTS 
HAS INPUT CAPABILITY 
USES PAGING OPTION: N 
BACKSPACES ON CTRL/H 
HIGH SPEED READER CHANNEL: 13 
HIGH SPEED PUNCH CHANNEL: 15 
TELETYPE CHANNEL? 12 
USES PAGING OPTION: N 
BACKSPACES ON CTRL/H 
HAS LOW SPEED TAPE 


SAMPLE SYSTEM GENERATION PRINTOUT (Continued) 


FLOPPY DISK DATA CHANNEL: 18 
FLOPPY DISK CONTROL CHANNEL: 11 
NUMBER OF BUFFERS: 4 
NUMBER OF DRIVES: 3 
‘DISPLAY DISK COMMANDS 


<<FUNCTIONAL UNIT ASSIGNMENTS: >> 
DI Els@sF . 
PL TELETYPEs @sL 
DP E2>5B 
PK TELETYPEs@sL 
HL E3sG5F 
SC E4sB 
CK TELETYPEs@5L 
CL TELETYPEs@5L 
Al HS TAPEs@6s5F 
AL TELETYPEs@5L 
AP 15B 
AK TELETYPEs@,sL Seg 
AH DECK ZEROs2esF 7 . 
AS 2B 
BC D2sB 
BM TELETYPEs@sL 
S26 1653 
S21 1638 
See 1698 
S23 162B 
S24 16B 
S25 165B 
S26 165B 
S27 16sB 
' $36 1658 
S31 165B 
$32 16sB 
S33 164B 
S34 16sB 
$35 162B 
S36 164B 
S37 162B 


CORE SIZE CIN K)s 12 


FORMAT DISK 
WRITE SYSTEM TO DISK 


OKAY AS IS? YES 
* : 


SAMPLE SYSTEM 


*DA D- 
FREE e 


SYS 
SYS] 
SYS2 
SYS3 
SY SM 
SRCE 
FSRC 
LIBN 
LIBE 
LIBF- 
CODSK 
EDI T 
ASMBN 
CROS 
FORT 
FOREN 
DUP . 
DEBUG 
EXER 
ABCS 
DPCS 
De 36 
De 3 6X 
De AGB 
De35 


“LOC. . 


RLOA 
SD3 6X 
ASMBE 
ASMBF 


eRe 


1321 


14° 


KE 


AK 


OK 


# 
xe ae 
2K 
OK 
2K 
eK 


KK 
* 
*K 
ek 
KK 


kK 


4K 
ok 
OK 
* 
sit 2 


+R FS 


*K 
eK 
* 
# 
eK 
re 
eK 
A 
2K 
ke 


GENERATION PRINTOUT (Continued) 


ADDRESS OF FIRST FREE SECTOR = 
UNCONFIGURED BOOTLOADERs SIO PACKAGE, AND EXECUTI VE 


“COLD START" FILE 


“WARM START" FILE 

STANDARD EXECUTIVE RELOAD . 

SYSTEM MAP 

DEMO PROGRAM SOURCE C ASSEMBLY LAN GUAGE) 
DEMO PROGRAM SOURCE (FORTRAN) 
NON-EAU MATH LIBRARY 

EAU MATH LIBRARY 

FLOATING POINT MATH LIBRARY 

BATCH FILE FOR COPYING MASTER DISK 
EDI TOR 

NON-EAU ASSEMBLER | 
CROSS-REFERENCE GENERATOR 

FORTRAN PASS ONE 

NON-EAU FORTRAN PASS TWO 

DISK UTILITY PACKAGE . 

SIO ENVIRONMENT DEBUGGER 

FDS DIAGNOSTIC 

CONFIGURED BCS FILE 

DISK PREPARE CONTROL SYSTEM 

FDS BCS DRIVER- 

FDS BCS DRIVER EXTERNALS 

TTY BCS DRIVER 

CMTS BCS DRIVER. 

INPUT/OUTPUT CONTROL 

RELOCATING LOADER | 

SOURCE OF FDS BCS DRIVER EXTERNALS 
EAU ASSEMBLER 

FLOATING POINT ASSEMBLER 


_EAU/FLOATING POINT FORTRAN PASS TWO 


«LD DI3LD D23LD D33LD D4 


Dis 

SRCE 
FSRC 
SD3 6X 


De: 


CODSK 


D3: 

De 36 
De 36X 
DeAO 
De35 
elOCe 
RLOA 


DA? 
LIBN 
LIBE 


LIBF 


VI. 


FDOS EXECUTIVE COMMANDS 


A summary of the Executive commands appears in an appendix 

of this manual. When the Executive is ready for a command, 

it types "*" on the console device, rings the’console device 
bell, and waits for a command line to be entered. A command 
line consists of one or more commands, each, except the last, 
terminated by a semicolon. A command consists of a two-charac-— 
ter command code, optionally followed by a space and a variable © 
number Of parameters, each, except the last, followed by a comma. | 
If a given command can accept parameters but not all are supplied, 
the Executive supplies "default" values for the missing ones. 


The parameters for a given command must be supplied in a 
fixed order. If it is desired to omit (i.e., use the de- 
fault value for) a given parameter but specify some or all 

of the following ones, simply type the comma which would 
normally follow it, but with no non-blank character between | 
it and the comma following the previous parameter, if any, 


or the bkank following the two- character command code. 


For example, 
CO +42 
requests the Executive to perform a copy function using © 


default values for the first, second, and fourth parameters 
and the value "2" for the third parameter (in this example, 


‘two files of data are copied from DI to DP in the ASCII mode). 


Several commands may be typed on one line (or placed in one 
record) by separating them with semicolons. For example, 
if it were desired to skip two files on logical unit El, 
copy the third file (in absolute binary format) from El 
onto cassette deck two, write an end-of-file on deck two, 
and then rewind deck two, the following command sequence > 
would be used: ; . 


SK E1,2;CO El,2,,BA;WE 2;RE 2 


An important feature of FDOS is the handling of the Batch mode. 
Operation in the Batch mode of the Executive differs from normal 
on-line operation in that command lines are taken from the Batch 
Command unit (BC), and messages, including the actual command 
strings, are sent to the Batch Message unit (BM). Batch command. 
lines can be intermixed with data input if BC is set to the | 
same unit as DI (see example under Write command and the CODSK 
batch file in the INSTALLATION OF SOFTWARE Appendix). 
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VIA. 


VI.B. 


VI.C.: 


The Batch mode is entered via the Batch command (BA). The 
Executive remains in the Batch mode until one of the following 


TeCurs: b4 


* A- Batch Exit command is received from BC. 
; * An EOF is detected on BC. 
* An I/O error is detected. 


In addition to the standard HP feature of RUBOUT deleting 
(via the SIO driver) the current ASCII anDUE line, FDOS has . 
the following convenience features: _ 
* Character delete; CTRL/H (hold CTRL key depressed, 
then strike H) deletes ene previous character and 
echoes it back. 
* Carriage Return echo; if. a LINE FEED is typed to ter-. 
Minate a line, a RETURN is- automatically echoed if one 
was not typed prior to the LINE FEED. 


The Executive commands ined the foirewing general types. 
UNIT MANIPULATION COMMANDS | 
The unit manipulation commands facilitate file positioning; 


these include Rewind, Skip, and Write End-of-File. If an 
illegal command is attempted on a unit (e.g., Writing an 


_End-of-File on the photoreader), the command is ignored and 


"IMPROPER REQUEST (unit)" is printed on the console device. 
DATA UTILITY COMMANDS 


These commands facilitate the transfer of data to and from 
the various units supported by FDOS. The data utility 
commands include Assign, Reserve File, Copy, Verify, Dump, 
List, and Write. | 


PROGRAM UTILITY COMMANDS 
These commands deal with the handling of data in the standard 


(absolute) binary format recognized by the System Loader. 
They include the Batch, Go To, If Disk, Save Start Address, 


Save, and Run commands. 
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VI.D. 


VILE. 


DISK SYSTEM COMMANDS 


These commands are concerned with the Disk Directories, the 
Logical Unit Directories, and disk formats. They include For- 
mat Disk, Disk Directory, Logical Unit Directory, Rename, 

Delete, Queue, Temporary Queue, Restore, and Zero System commands. 
These disk system commands have no meaning for other peripherals 
supported by FDOS. 


DESCRIPTION OF FDOS COMMANDS 


The following pages give a description of each of the FDOS 
commands. 7 | 
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VI.E.1 ADD TO LOGICAL UNIT DIRECTORY 


Purpose: Add files to the end of a logical unit directory. 


Format: AQ DUNT, NAME1,NAME2,... 
DUNT,NAME1],etc., are as for QU. 


- Comments: Same as QU command, except that names are appended to the 
end of the specified LUD. 
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VI.E.2 ASSIGN 


Purpose: Assign a physical unit to a functional unit. 


Format: AS FUNIT,PUNIT, LCTR,PGCHR 
where: FUNIT = a functional or physical unit 
| PUNIT = a physical unit | 7 
LCTR index to the system's table of line counters 
PGCHR = N None | F Formfeed 7 
L Linefeed X Special character set during Sys-Gen. 


Comments: FUNIT is set to point to PUNIT. 


If PUNIT, LCTR and PGCHR are not specified, they are not changed. 
If "AS FUNIT,?" is typed, the assignment of the unit is listed. | 
LCTR and PGCHR may be replaced with a "B" to specify that the 
unit is a binary unit (not capable of page formatting). 
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VI.E.3 BATCH 


Purpose: Enter Batch mode 


- Format: BA NAME | 7 
NAME = name of file containing the Batch commands. 


Comments: A "batch" flag is set in the loader area (X7536B). Sub-— 
sequently, all command lines are input from BC, rather than CK as in 
normal Executive operations. A return to the normal "on-line" opera- 
tion of the Executive occurs when an EOF is detected on BC, when a 
BX command is received from BC, or if an I/O error is detected, 


During Batch operation, Executive console messages (such as "EOF" 
reports during a copy) and echoing of Batch commands use BM for output, 
rather than CL as in normal operation. 

If NAME is not specified, the next file on BC is used. NAME can only 
be used if BC is a disk logical unit. 


VI - 6 


VI.E.4 BATCH EXIT . 


Purpose: Return from Batch mode to the on-line (interactive) mode 
of Executive command input. 


Format: BX NAME | 
NAME = File name to be used for next BA command. 


oe 


Comments: A TQ of NAME to BC is done. A subsequent QU,RE, etc. of 
BC will override this TQ. If NAME is not specified, no action is taken 
with respect to BC. | 


“WE gS 


VI.E.5 COMMENTS 


Purpose: Allow comments to appear. on Batch or on-line mesSage units. 


Format: kk Text 


Comments: All characters after ** are ignored, up to the next Linefeed. 


N.B.: A space must follow the **, 
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VI.E.6 . COPY 


Purpose: To duplicate one or more files 


Format: CO SRCE,DEST,+#,MODE 
Where SRCE = a physical or functional unit 


DEST = a physical or functional unit | 
Se = number of files to copy | 
MODE = A(ASCII), BA(absolute binary), or B(relocatable 


binary) 


Comments: The remainder of the current file and the #1 subsequent files 
of SRCE are copied onto DEST, each followed by a-file mark. — 


If @ is specified for #, 1 is used, but no file mark-is written onto 
DEST. This feature, in conjunction with the Save command, is very 
useful in "patching" absolute binary programs. For example, suppose 
it were desired to change the contents of location 191B (the SIO 
Input pointer) whenever the Assembler (ASMB) is run. Then the 
following procedure could be used: © | 


1. Load the system (by starting at X7544B). Halt the 
computer and change 181B to the desired value. Re- 
start at the Executive restart address ( (X-1) 499 2B) . 


2. Type QU D4,ASMB;QU D3,ASMB 
| CO D4,D3,%,BA;SA D3,191B;WE D3 
RE D4;RE D3;VE D4,D3,%,BA;DU D3,,,,BA 


3. If the response on the console device to the last line 
above is | | a 


EOF D4 | 7 
GPP4G9 PCP1PZ1 (new contents) (checksum__) 
EOF D3 7 | = 


then the operation has been performed successfully. 


Although this example would accomplish the desired re-assignment of the 
input device (DI), a more convenient way would be via the Assign command. 


VI-9 © 


If SRCE is not specified, DI is used. 
If DEST is not specified, DP is used. 
If # is not specified, one is used. 


If MODE is not specified, ASCII is used. 
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VI.E.7 DISK DIRECTORY 


Purpose: To produce a list on a Specified unit the names of programs 
| residing on the disk in the specified drive. 


Format: DI DISK,DEST ; 4 - 
Where DISK = D,E,F, or G (floppy disk drive), * 
DEST = a physical or functional unit 


* or a physical (logical) unit or functional unit 
assigned to a disks' logical unit. 


Comments: Each disk has a disk directory recorded in sector 1 of track 0. 
This is different from the logical unit directories in that: 


(1) It contains only names of files actually recorded on 
the disk. 


(2) It contains the starting sector address of each file. 


-(3) It contains the starting sector address of the chain of 
free disk blocks. % : : 


(4) The order of files listed in it is of no significance. 
(See comments under LD command) 


If DEST is not specified, CL is used. 
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VI.E.8 DISK DIRECTORY WITH ADDRESSES 


Purpose: To produce a list on a specified unit the names of programs 
-and their initial sector address. 


Format: DA DISK,DEST 
Where DISK = D,E,F, or G (floppy.disk drive), * 
DEST = a’physical or functional unit 


* or a physical (logical) unit or functional unit 
assigned to a disks' logical unit. 


Comments: This command is similar to the Disk Directory command (DI); 
in addition to the name of the program, the initial sector address 

. of that program is printed. In addition, the symbol ".FREE." is. 

printed, followed by the address of the first available (but not 
necessarily lowest numerical) sector of the free storage list. 


If DEST is not specified, CL is used. 
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VI.E.9 DELETE 


Purpose: To remove a file from the specified disk and free the sectors 
comprising it for reuse. © 


Format: DL DISK,NAME 
Where DISK = 


D,E,F,or G (floppy disk-drive), * 
NAME name of file to be deleted 


* or a physical (logical) unit or functional wRit 
aseaened to a disks! logical unit. 


Comments: The file name is removed from the directory, and the chain of 


sectors comprising it are added to the beginning of the free storage 
list, i.e., the disk directory's free storage pointer is set to the first 
sector of the deleted file, and the last sector of the deleted file, 
which previously contained an end-of-file indication, is set to point 

to what was previously the first sector of the free storage list 


If the file deleted is one of the Fixed Address files (SYS%, SYS1, 
SYS2,SYS3 or SYSM) then the first sector (14B, 15B, 16B, 17B or 13B) 


is not added to the free storage list, but the remaining sectors of that 
file are added to the free storage tS Cs 
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VI.E.10 DUMP DISK 


Purpose: Produce a listing on a specified unit of the contents of a 
specified range of disk sectors. 


Format: DD DEST,DISK, LO, HI 

: Where DISK is a floppy disk drive, * | 
DEST is a physical or functional unit 
LO and HI are the first and last (octal) disk 
addresses of the block of sectors to be dumped. 


* or a physical (logical) unit or functional unit 
assigned to a disks’ logical unit... 


Comments: The dump is printed in the following format: 


(sector address) | 


@: word word © SAY jets He word (8 words per line) | 
1p: ‘word - word et a a word | 
17¢: word word ae. vs word 
(sector address) | | _ 
@: word word i word 


If DEST is not specified, CL is used. 
If LO is not specified, 2 is used. 

If HI is not specified, LO is used. © 
DISK must be specified. | < 
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VI.E.11 DUMP MEMORY. 


Purpose: 


Produce a listing on a specified unit of the contents of a 
specified range of memory locations. 
Format: DM DEST,LO,HT , ‘ 
Where DEST is. a physical or functional unit > % 
LO and HI are the first and last (octal) addresses 
of the block of memory to be dumped. 
bee 
Comments: The dump is printed in the following format: 
address: word word — word | (8 words per line) 


address: word word ee word 


se 


If DEST is not specified, CL is used. 
If LO is not specified, 2 is used. | 
If HI is not specified, LO is used. 
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VI.E.12 DUMP RECORDS 


Purpose: To provide a listing of specified records of a (possibly) 
- binary file. 


Format: DU SRCE,DEST,LO,HI,MODE 
Where SRCE = a physical or functional unit 
DEST = a physical or functional unit 


LO = First record to be dumped (counting the next 
record as #1) 

HI = Last record to be dumped 

MODE = A(ASCII), BA(absolute. nee ee or B (relocatable 
binary) 


Comments: 


If SRCE is not specified, DI is used. 

If DEST is not specified, CL is used. 

If LO is not specified, 1 is used. © 

If HI is not specified, dumping proceeds until an end-of- 
file on SRCE. 

If MODE is not specified, A is assumed. 


The process of dumping proceeds as follows. Each specified record is 
read from SRCE in the MODE specified. The characters of the record are 
then packed two per word, first the high order half, then the low order 
half. A listing of these words is then printed. In the listing, each > 
word appears as six (6) octal digits, and these are printed eight (8) 
per line, using as many lines as necessary. Thus, for example, if the 
second record of the third file of logical unit D2 contains the ASCII 
character string ABCDEFGHIJKLM, then the first line of the output from 
the command 
RE D2;SK D2,2;DU D2,,2,5 

will be | eS ey acre. 
| BG495G2 G41594 42596 $43519 944512 paooee : sd 


Note that an assumed space character fills the right half of the last 
word. 


In most applications, CL or LP would be used for DEST. 
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Vi. Eb. d2a. DUMP VERIFY ERROR RECORDS 


To provide an octal dump of the pair of records 
which caused a VERIFY to produce a COMPARE ERROR. 


DV DEST . 
Where DEST = a physical or functional unit 


Comment: The program prints 


.SOURCE nnn (where nnn is the decimal length 
in words or ee of the iast record read on the 
source device). 


and prints an octal dump only the ldst record “cae on the source 


device, then prints | 


DESTINATION nnn | 
treating the destination device record similarly. 
If DEST is not specified, CL is used. 
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 VI.E.13 FORMAT DISK 


Purpose: To prepare a virgin disk for use with FDOS 


Format: FD DISK 
Where DISK = D,E,F, or G (floppy disk drive), 


Ee 


* or a physical (logical) unit or functional unit 
assigned to a disks' logical unit. 


Comments: 


(1) The sectors of the disk, aside from those of track zero, 
are chained together into a free storage list. They are 
not chained in simple ascending numerical order of address.. 
For each track, the chain starts at sector zero, proceeds 
_ through the even sectors (0,2,4,6,1¢8,12, 14,16), then through 
the odd sectors (1,3,5,7,11,13,15,17). 


(2) An initial aes sieesvors = written into Sector 1 of 
track zero. This contains 28 (a pointer to the first 
block of the free storage list) in its first location. and — 
the five Fixed Address files (SYS, SYS1, SYS2, SYS3,and _ 
SYSM) and addresses (14B, 15B, 16B, 17B, and 13B)as entries. 


(3) Empty logical unit directories are written into suckers 
. 4,5,6, and 7 of track zero. 


(4) The Fixed Address files are generated as empty (EOF) and 
written out. 


(5) The unconfigured Boot loader is weieten: in sector three of 
track zero. é 


(6) The configured eye cen Loader is written in sector zero of 
track zero. 


Wrsie - 


VI.E.14 GO TO 


Purpose: To allow the user to transfer from the Executive to a. 
specified memory location. 


Format: GON 
Nis the octal address to which to transfer. 


Comments: This command is useful in transferring to a core-resident 
program (such as the Debugger). 
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VI.E.15 IF DISK 


Purpose: Determine whether or not the specified unit is a disk 
— logical unit. 


Format: ID UNIT 
| Where UNIT = a physical or functional unit 


Comments: If UNIT is a disk logical unit, the next command in the 


command line is executed. If not, the remainder of the command line 
is ignored. 
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VI.E.16 LIST 


Purpose: To provide a listing of specified records of an ASCII file. 


Format: LI SRCE,DEST,LO,HI 
Where SRCE = a physical or functional unit 


DEST = a physical or functional unit 

LO = First record to be listed (counting the next 
record as number 1). 

HI Last record to be listed. 


Comments: 


If SRCE is not specified, DI is used. 

If DEST is not specified, CL is used, 

If LO is not specified, 1 is used. 

If HI is not specified, listing continues until an End-of- 


File on SRCE. 


In most stati entanne encase would be used for DEST. If a cassette 


deck or disk logical unit is specified, the effect is to copy the speci- 
fied records from SRCE to DEST, a function which cannot otherwise be 
performed. To skip records, BK could be used for DEST. 


to determine the contents of the second file 


If one wished, for example, ! 
this could be 


of the cassette in deck 2 by listing the first five eee 
accomplished by using the command 


RE 2;SK 2;LI 2,,,5 
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VI.E.16a LIST VERIFY ERROR RECORDS 


Purpose: To provide an ASCII printout of the pair of 
records which caused a VERIFY to produce a 
COMPARE ERROR. 


Format: LV DEST 


Where DEST = a physical or functional unit 


Comments: The program prints 


SOURCE nnn (where nnn is the decimal length in 
words or bytes of the last record read on the 
source device). : 


and prints an ASCII dump of the last aceone read on the source. 


device, then pEante 


DESTINATION nnn 
treating the destination device record similarly. 
if DEST 13.:not specified, CL is uses 
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VI.E.17. LIST ALL UNITS 


Purpose: To print the contents of the Functional Device Table (FDT). 


Format: LA DEST 
Where DEST = unit on which to produce the listing. 


Comments: The FDT is printed on DEST in the same format as during the 
system generation. 


If DEST is not.specified, CL is used. 
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VI.E.18 LOGICAL UNIT DIRECTORY 


Purpose: To list the file names comprising the specified logical unit. 


Format: LD DUNT : - | . 
Where DUNT = D1,D2,D3,D4 (logical units of disk drive D) 
| ' EL,E2,E3,E4 (logical units of disk drive Rk). 
F1,F2,F3,F4 (logical units of disk drive F)- 
G1,G2,G3,G4 (logical units of disk drive G) 


or functional unit assigned to a disk logical 
unit. 


Comments: A logical unit consists of a list of names (up to five 
alphanumeric characters, first alphabetic) in a fixed order. These 
names correspond to potential files on the corresponding disk. | 
These lists, corresponding to the four logical units of the given 
disk, are kept in four sectors of track zero of that disk: 


Sector (octal) Logical Unit 
y 4 
6 1 
6 2 
7 3 


These directories can be set up by the user through use of QUEUE 
command. — 3 2 | 
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VI.E.19 QUEUE 


Purpose: To set up a directory of the specified logical unit. 


Format: QU DUNT,NAME1,NAME2,. .. . 

Where DUNT = D1,D2,D3,D4 (logical units of disk drive D) 
E1,E2,E3,E4 (logical units of disk drive E) 
Fl,F2,F3,F4 (logical units of disk drive F) 
G1,G2,G3,G4 (logical units of disk drive G) 
or functional unit assigned to a disk logical 
unit. 

Where NAME1, NAME2, . . . are file names 


Comments: (See comments under the Logical Unit directory command - LD.) 


The LUD for DUNT is set to consist of NAME],NAME2,..., and UNIT is 
rewound, so that it is positioned at NAME1. 


QU DUNT deletes all names from ene LUD, but does not Agee the files 
from the disk (or Disk Directory) . 


- When the comming ou DUNT,NAME1 is éGek, -NAMEL gets added to the LUD, 
but NAME1 does not get added to the Disk Directory until it is used 
for an output function. 
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VI.E.20 RESERVE FILE 


Purpose: Reserve a file of a specified length. 


Format: RF DISK, NAME,# 
Where DISK = D,E,F,G, * 
NAME File name 
+ = Number of sectors 


* or a physical (logical) unit or functional unit 
assigned to a disks! logical unit. 


Comments: A file of the specified fenoee and with the specified NAME: is 
created on the Rarcleand disk, 

If a file called NAME already exists on the given disk, its length is 
checked, and additional sectors are added to it if it is shorter than 
the number of sectors ePecnetce in the command. 


The purpose of this command is to create a file in advance of operating 
with it. This reduces the amount of head motion (therefore, time) re- 
quired in actually writing a file, since the free storage list (in 
track zero) does not have to be accessed each time another sector is 
required. | 


If, during subsequent output to this file, all reserved sectors are 
not used when the file is closed (by writing an EOF) the unused 
sectors are returned to the free storage list. If more sectors 

than were reserved are required during the actual output to the a 
file, additional sectors are taken from the free storage list. Thus, 
one needs only to seRPEORIGTS the number of sectors required for 

the file. . 
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~VI.E.21 REPEAT COMMAND LINE 


Comments: 


To cause re-execution of the command line 
up to this point. 


RP # . 
Where # = number of times to repeat (decimal) 


The command line, from the beginning, is 
re-executed up to the RP command for the. 
specified number of times (total.times = # #1), 
then the execution proceeds beyond the RP. 

If # is not specified, the command line will 

be repeated infinitely (not 32K - infinitely). 


If a cold-start reload is done in the repeated 
section each time, then the command line will | 
be repeated infinitely regardless of the value 
of #. If two RP commands are in one command 
line, the line will be repeated infinitely - 
the part before the first RP will repeat its 

# of times the first time, then for the # of 
times in the second command subsequently unless 
it is @ or unspecified, in which case it will 
continue to repeat according to its own #; 

the part between the two RP commands will - 
execute once each time the first runs out. 
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VI.E.22 RESTORE 


Purpose:. Restore the original SIO configuration. 


Format: RS 


Comments: A "warm start" entry is made to the System Loader, and the 
SIO driver area is restored from disk, wiping out the effect of any 
Assign commands. 
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'IT.E.23 RENAME 


Purpose: To change the name of a specified file on 
a specified drive. 


Format: RN DISK, OLDN, NEWN 
_ Where DISK = D, E, F, G (floppy disk. drive) ,* 
OLDN is the name of the file before renaming 3 
NEWN is the name of the file after renaming. 


* or a physical (logical) unit or functional unit assigned 
to a disks' logical unit. 


Comment: The name is enaneed in the disk directory. 
Also, the name word (which contains the name 
code computed from the file name) is changed 
in each block of the file. If the file in 
question is Queued on a disk logical unit, the 
name in the LUD is not changed. 
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VI.-E.24 REWIND 


Purpose: To position a unit at the start of the first file. 


Format: RE UNIT 
Where UNIT = a physical or functional unit 


Comments: If UNIT is a cassette deck, a rewind of the specified deck 
is initiated, and control returns to the user without waiting for the 
rewind to be completed. : 


If UNIT is a disk logical unit, the effect of the command is modification 
of the in-core logical unit parameter table (LUPT)” to indicate that the. 


unit is positioned at the start of file 1 of that unit. 


If UNIT is not specified, DI is assumed. 
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VI.E.25 RUN 


Purpose: To load a specified file from drive D and transfer control. 


Format: RU NAME,S.A.,parameters 


Where NAME = name of file. 3 
S.A. =’(octal) start address if standard not desired. 
parameters - format determined by program being called. 


Comments: Same as RD, except drive D is assumed. 


“VI-31 


VI.E.26 RUN FROM SPECIFIED DISK 


Purpose: To load a named file from a specified disk and transfer 
control. 


Format: RD DISK,NAME,S.A., parameters 
Where DISK = D,E,F or G (floppy disk drive), ts 


NAME = name of the file 

S.A. = address to which to transfer control if 
standard not desired. 

parameters - format determined by program being run. 


* a physical (logical) unit or functional unit assigned 
19 a disks' logical unit. : 


Comments: When this command ie wigan: the Disk Directory is read from 
DISK. This directory contains the names and starting sector addresses 
of the files on that disk. If the name is not found, a message to 

that effect is printed. Otherwise, the parameters are used to set up 
PARAM through PARAM+7 of the Communication Region, S.A. is used to set - 
STRTA in the Communication Region,. and a transfer is made to the System 
Loader ELOAD entry with the appropriate drive and sector address. 
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VI.E.27 SAVE 


Purpose: To write an absolute binary format image of the area of 
memory from FWA to LWA inclusively, capable of being loaded 
into memory locations ADDR thru ADDR+(LWA-FWA) at a later 
time. 


Format: SA DEST,FWA,LWA,ADDR 
Where DEST = 1,2,3 (cassette decks) 
D1,D2,D3,D4 (logical units of disk drive DD) 
El1,E2,E3,E4 (logical units of disk drive E) | 
F1l,F2,F3,F4 (logical units of disk drive F) 
G1,G2,G3,G4 (logical units of disk drive G) 


Comments: The portion of memory lying between the two addresses FWA 
and LWA (inclusive) is written on the specified unit as a series of 
128-word absolute binary format records. That is, 


S764GB ree - (#data words, i.e., 125, in high’ 
order) ; 
FWA + 125(n-1) . (starting address in memory of 


data of the n-th record) 


contents of first location 
contents of second location 


contents of 125-th location 


checksum (sum of the address and the data 
. words ) 


If the number of words written is not a multiple of 125, the n-th 
record is shorter, but of the same format as above. : 


If UNIT is not specified, DP is used. 


If FWA is not specified, then 2B is used. 
If LWA is not specified, then FWA (one word) is used. 
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If ADDR is not specified, FWA is used; ADDR specifies the intended 
_jJload address. Thus, the words written from memory locations FWA thru 
LWA will be loaded back into ADDR thru ADDR+(LWA-FWA) . 


N.B. No file mark is Wereeen after the data records, so multiple 

saves can be used to build a file. When the desired portions of memory 
have been saved, a file mark MUST be written (to close the file) using 
the WE command. , 


(See example under COPY command.) 
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VI.E.28 


SKIP 


Comments: 


To position a unit at the start of the N-th 


following file. 


SK UNIT, # 


Where UNIT a physical or functional unit. 


it = number of files to skip. 


If UNIT is a cassette deck, successive "search" 


commands are issued, and control returns to the 
user when the drive becomes "ready". 


If UNIT is a disk logical unit, the in-core 
logical unit parameter table (LUPT) is modified 
to indicate position at the start of the #-th 
file following the current one. 


If UNIT is not specified, DI is assumed. 
If # is not specified, 1 is assumed. -_ 
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VI.E.29 SAVE START ADDRESS 


Format: 


Comment: 


To write an absolute binary format record of 
locations 2B and 3B as the standard start 
procedure, using the specified address as the 


Start address (location 3). 


SS DEST ADDR 


Where DEST = a physical or functional unit. 
ADDR. = (octal) start address desired. 


An absolute binary format record (to be loaded 


into locations 2B and 3B) 3S written on the 


specified unit, without disturbing locations 
2B and 3B. 


This is usually used in conjunction with; and 
usually prior to, the SAVE command when building. 
a file. 

N.B. No file mark is written after this record 


If DEST is not specified, the DP is assumed. 
ADDR must be specified. | | 
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VI.E.30 TEMPORARY QUEUE 


To temporarily attach the specified file to the specified 
logical unit. 


Purpose: 


Format: TQ DUNT ,NAME 


DUNT = disk logical unit, or functional unit assigned to a 


disk logical unit 
NAME = name of file to be attached. 


Comments: The in-core LUPT is set up to the start of the file called 
NAME. The in-core file number is backed up by one, so that when EOF 
is detected in NAME, the LUPT is set up as it was before the TQ. 


The LUD on disk is not modified, so TQ can be used with a write- 
protected disk. : 


V3.7 


Purpose: To compare one or more files. 


Format: VE SRCE,DEST,+#, MODE... - 
Where SRCE = a physical or functional unit 


DEST = a physical. or functional unit 

Bo = number of files to compare 

MODE = A(ASCII), BA(absolute binary), B(relocatable 
binary) 


Comments: The remainder of the current file and the #-1 subsequent 
files of SRCE are compared with the corresponding files of DEST. 


T£ OW is specified for #, 1 is used, but the process terminates with 
the detection of a file mark on SRCE. (Normally, a final read of 
DEST would then be made and an error reported if no file mark were 
detected there.) 


If SRCE is not specified,DI is assumed. 
If DEST is not specified,DF is assumed. 
Tf # is not specified, 1 is assumed. 

Tf MODE is not specified, A is assumed. 


(See the example under COPY.) 
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VI.E.32 WRITE 


Purpose: To allow ASCII data to be output directly into a file on 
a unit. 


Format: WR DEST,SRCE 


(line of text) 
(line of text) 


(CTRL/D) . | 
Where DEST = a cassette deck, a disk Logical unit, T,L, or P 


Comments: As each line is input from SRCE (normally a keyboard), it is 
output to DEST. When the CTRL/D (followed immediately by Carriage 
Return then Line Feed) is input, a file mark is written on DEST and | 
control returns to the user. : 


For example, if the user wanted to put a file of Batch commands at the 
start of logical unit El, the following sequence could be used: 


RE E1;WR El 

RE 2;SK E1;CO 2,E1;RE 2;RE E1;SK E1;VE 2,El1. 
RU. ASMB,, ,2;BX 

(CTRL D) 


If El is subsequently used as the batch input unit and DI, the above 
sequence will cause a source program to be copied into the second 
file of El and assembled, after which the system will leave the Batch 
mode. 


If DEST is not specified, DP is used. 
If SRCE is not specified, CK is used. 


Vie39 


Vic Bess 


WRITE END-OF-FILE MARK 


Purpose: 


Format: 


Comments: 


To terminate the output file. 


WE DEST 
Where DEST = a physical or functional unit. 


If DEST is a cassette deck a°3/4" gap of blank 
tape is written, followed by a record consisting 
of the single character 4B (control D, or EOT). 


If DEST is a disk logical unit, an end-of-file 
indication is written in the current block of 
the current file, any remaining blocks of the 
file are released, and the in-core logical unit 
parameter table (LUPT) is modified to indicate 
that the unit is positioned at the start of the 
next file. 


If DEST is another type of device, the actions 
specified for the Write-end-of-file command is 
SIO/DIO (see Section IV.D.5). 


N.B. The integrity of the data written into a 
file is not assured unless the file is properly 
terminated. 

If DEST is not specified, DP is assumed. 

(See comments under the DELETE command 


describing how the remaining blocks of 
the file are released) 
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VI.E.34 ZERO SYSTEM 


Purpose: To clear all SIO disk buffers of any holdover sectors 
before changing disk cartridges in a drive. 


Comments: The hueristics used in the SIO Driver to minimize disk 
sector reading and writing cause sectors to reside in core. Ifa 
disk is changed in a drive, and a sector is accessed that resides in 
core from the previous disk, SIO will use the old sector rather than 
read the new one (usually resulting in a Format Error). 


The ZS is used to clear out all SIO buffers so that there is no hold- 
over, and all new sectors are read. . 
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VILE 


FDOS EXECUTIVE MESSAGES 


1. The FDOS Executive prints messages when certain conditions 


arise. Those which apply generally to the various commands are 


as follows: 

ILC 7 
The last command processed by the Executive is de- 

fective in some way, most probably because an illegal 
character appeared or because one of the parameters 
does not fall within the expected set of values. 
The Executive discards the remainder of the command 
line and waits for the operator to type another. 


NOT READY (unit) . 

When the Executive attempts to peeecera an operation 

on a unit, the driver, DIO, checks to see if the unit 

is ready before issuing the command. If the unit is 
not ready, the driver returns the "not ready" in- 

dication, and the Executive prints the "NOT READY 

(unit)" message. 


WRITE LOCK (unit) 

This message is printed if DIO returns the "write 
locked" indication in response to an attempt to 
write ona Diagn eon disk or cassette deck. 


EOF (unit) 
This message is printed if DIO returns the "end of 
file on read" indication in response to an attempt 
to read data from a unit. This is usually not an 
error condition during executive operations. It 

is printed mainly to help the operator keep track of 
the progress of multifile operations. 


END OF TAPE (unit) 
This message is printed if DIO acGine the "end of 
tape" indication on an attempted read/write operation. 


This results in the termination of the command and the: 


loss of the remainder of the command line. The 
Executive waits for the as to type another 
command. 
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WRITE ERROR (unit) 
This message is printed if DIO returns the "rate 
error" indication in an attempt to write ona disk. 


READ ERROR (unit) 

This message is printed if DIO returns a "rate error" 
or "CRC" (parity) error" indication in an attempt to 

read from a disk, or if DIO returns a "parity error" 

indication in an attempt to read from cassette. 


FORMAT ERROR (unit) 

This message is printed if, while accessing a named 
disk file, the name code in the first word of each 
sector does not :verify with the file name i(chaining 
error).. | | 


UNKNOWN DEVICE (unit) 
No such peripheral device has been defined (at 
sys-gen time) in the system. 


IMPROPER REQUEST (unit) 
This message is printed if unit specified cannot 
perform the function requested. 


TYPE 'GO' WHEN READY 


This message is printed after "NOT READY (unit)" and 
"WRITE LOCK (unit)" messages and at other times. 

When the operator types "GO", the Executive retries 
the operation or goes on to its next task. If the 
operator types "NO", the Executive aborts the command. 


2. The “fixed address files" reserved for the basic FDOS soft- 
ware system are named SYS@, SYS1, SYS2, SYS3, and SYSM. To 
protect these, and to allow for other protected files, any file 
whose name begins with the letters "SY" is considered a "system" 
file. When such names are input to the Executive the following 
is typed for each reference: 


SYxx?! 
ARE YOU QUITE SURE? 
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Only the response of "JA" will cause the Executive to continue 
processing the requested command. Any other response will cause 
the "ILC" message, and that command (plus the remainder of the 
command line) will be aborted. 


To avoid inconvenience when intentionally doing work with these 
files, the Executive has two additional commands: 


SE System name work Enable 
SD System name work Disable 


In the Enabled mode (SE), the above discussed verification 
message is not typed, nor is a response expected. The "SD" 
command returns the Executive to the normal mode (ie., the 
verification is performed on each "SY" reference). In addition, 
the execution of a RE, WE, FD, DL, RN, AQ, or QU command causes 
the Enable mode to be exited at the end of the current command 
line; an illegal command or system reload causes an immediate — 
exit from the Enabled mode. 


VI.G. PAPER TAPE EQUIPMENT CONSIDERATIONS 


Since paper tape equipment does not have file-manipulation 
capabilities, special considerations apply when it is specified 
in a command. 


1. Ten nulls (feed frames) define an End-of-File on input from 
paper tape. Thus, when mounting a paper tape on the low-speed 
(TTY) reader, valid data for the desired file must be placed 
within ten frames of the read station; if this is not done, an 
"EOF LS TAPE" message will occur upon subsequent input from the 
low-speed reader. 


2. On input from the high-speed reader, nulls are ignored until 
a valid record (of the specified type) is encountered; thus the 
tape can be mounted at any point on the leader. 


3. If an operation with paper tape is aborted before completion 
(such as a compare error when verifying from paper tape to some 
other device) the driver retains the fact that the paper tape 

is in the middle of the file. Thus, if the operator positions 

the paper tape back to the beginning, the driver must be informed 
of this manual intervention. This can be accomplished by rewinding 
the appropriate reader (RE HT or RE LT). A HLT 6B will occur, 
thus reminding the operator to reposition the paper tape; when 
complete, press RUN. 
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4. If an ASR33 punch is used, two halts apply: 


HLT 56B - printing complete; turn on low-speed 
punch and press RUN. 


HLT 55B - punching complete; turn off low-speed 
punch and press RUN. 
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VII. SYSTEM PROCESSORS 


The FDOS system processors provided are (primarily) 
modified versions of standard Hewlett-Packard pro- 
grams. The modifications allow the various proces- 
sors to be called by (and return to) the FDOS Exec- 
utive, thus achieving automatic, "hands off" opera- 
tion. The modifications also allow the processors 
to position the I/0 media between passes, providing 
the media is disk or cassette. If the I/O unit de- 
fined is paper tape, certain halts will occur during 
processor operation to allow manual intervention; 
upon completion, RUN is depressed to continue the 
processor. These halts are: 


HLT 66B - end of paper tape; rewind tape, mount in 
reader, and press RUN. 


HLT 57B - end of source section; mount next paper. 
tape and press RUN. 
HLT 56B - (ASR 33 only) printing complete; turn on 


low-speed punch and press RUN. 
HLT 55B - (ASR 33 only) punching complete; turn off 
low-speed punch and press RUN. 


VII.A. EDITOR 


This program is a modified version of the Hewlett- 
Packard Editor 20100B. Its operation is very similar 
to that described in the manual HP 02116-9016, with 
the primary difference that the "/D" device selection 
(instead of "/M") refers to input and output via FDOS 
functional units. | 


The following brief summary of the editor's operation 
can be supplemented by reference to the above-mentioned 
HP manual: | 


VIL Asds Entry of the Edit File. 
The program asks for the edit file device. 
The following answers are accepted: 


/T Edit file is to be typed 
/A Edit file is to be read from AK. 


The Edit File consists of combinations of the following 
commands: 


/F,n Open the n-th file. That is, copy files from 
the Input unit to the Output unit until the begin- 
ning of the n-th file is reached. /F,1 is assumed 
if any edit command other than /L or /L,n appears 
as the first line of the edit file. 
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/I,n Insert one or more lines after the n-th line of 
the currently opened file. The lines inserted are 
all those lines of the edit file lying between this 
control statement and the next control statement. 


/D,n,m Delete line n through m of the currently opened 
file. /D,n is used to delete the n-th line. 


/Rsnsm Replace lines n through m of the currently opened 
file. /R,n is used to replace the n-th line. 
/Rysn,m has the same effect as /I,n-1 followed 
by /Dsnsm:. 


/CI,5n,m Insert text after the m-th character of the 
n-th line of the currently opened file. The text 
to be inserted appears on the line following this 
control statement. 


/CD,n,m,k Delete characters m through k of the n-th line 
of the currently opened file. /CD,n,m deletes 
the m-th character. 


/CR,n,m,k Replace characters m through k of the n-th line 
of the currently opened file. This ‘is equiva- 
lent to /CI,n,m-1 followed by /CD,n,m,k. 


/L,n List the n-th file. /L is equivalent to /L,1. The 
only other command allowed in an edit file contain- 
ing this command is /E. 
NOTE: that the HL device must have been assigned. 


/f Delete the last previous line of the edit file. 


/E Close the currently opened file (if any), i.e., copy 
the remainder of it to the Output unit and terminate 
the edit. Note that if a /L,n command appears as the 
only other line in the edit file, no file is considered 
to be open, so no copying to the Output unit occurs. 
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VII.B 


If an end-of-file is encountered before a /E command is found, 
the editor says “END OF TAPE". 


To read the remainder of the edit file from another tape, 
position the new tape in the Input unit and type "GO". 


To terminate the edit file, type /C followed by /E. 
Specification of the symbolic file device. 


The program asks for the symbolic file source device and the 
symbolic file destination device. The possible replies are: 


/D Use DI or DP. 
/A Use ATI or AP. 


If an end-of-file or end-of-punched-tape is encountered during 
symbolic file input, the editor says "END OF TAPE". If further 
Symbolic input is not required, the edit process is completed 
and a return to the Executive is made via a transfer to the 
System Loader (X754@B). If further symbolic input is required 
(e.g., in the /F,n command), the Editor proceeds to input the 
next file from the input device. If paper tape is being used, 
the operator must mount the next tape in the reader. 


ASSEMBLER 


This program is a modified version of the Hewlett-Packard 
Assembler 24031B. It is supplied in three versions: Floating 
Point (ASMBF), EAU (ASMBE), and Non-EAU (ASMBN). It uses DI 
for source input, DP for binary output, and offers a choice 

of list output to HL or PL. Listing uses PL if the P option 
is specified during the call of the assembler (e.g., 

RU ASMBF,,,,P). 


The assembler recognizes I/O options specified by the contents 
of certain locations in the parameter area of the Communication 
Region. If the assembler is loaded using the Executive 
program, these can be set by a call of the form: 


RU ASMB,,P1,P2,P3 


NOTE: The calls for all three assemblers (ASMBF, ASMBE, and 
ASMBN) are the same; the name of the version desired would be 
used instead of ASMB. It may be desirable to delete the unused 
assemblers from the working disk, and rename the desired one to 
ASMB (see Software Installation section). 
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If the Executive is not used, Pl through P3 must be set into 
cells PARAM +1 (X7525B) through PARAM +3 .(X7527B). Numbers 
must be entered as their actual values, while letters are 
represented by their 7-bit ASCII codes. Missing parameters 
are set to zero. The parameters are interpreted as follows: 


P1l:K = accept control statement from PK; 

I = ignore first statement of the source program 
(assumed to be the control statement) and 
accept control statement from PK; 

If Pl is any character other than I or K, the 
control statement is expected to be the first 
statement of the source program. 


P2: The number, counting from one, of the file on 
DI to be assembled; if not specified, defaults 
to assembling the first file. 


P3:P = Write listing and symbol table (if requested 
in control statement) to PL; otherwise use HL. 
NOTE: If HL used and it is a disk logical unit, 
a file must be queued on HL even though no 
listing or symbol table is requested; this is 
because HL must be capable of receiving any 
error messages, etc., that are generated. 


The assembly control statement consists of "ASMB" followed by 
one or more of the following: 


,A. Absolute assembly 

ok Relodatable assembly 

,B Produce a binary output 

,L Produce a list output P 


,T Write the symbol table at the end of the list output 
(if any). 


,C Follow the assembly by a call to the Cross-Reference 
Table Generator. 


NOTE: If the listing. is directed to HL, the normal error summary 


is also printed on CL at the end of each pass for the 
SpeEars: Ss convenience. 
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Use of the Assembly Control Statement C option causes the code 
for CROS to be set in LERR (X7537B) before the transfer to the 
System Loader (X7549B) which occurs at the end of the assembly. 
The program first clears PARAM+1 (X7525B) and then loads the 
Cross-Reference Table Generator. 


If the Assembler detects an End-of-Source Section condition 
(End-of-File on disk/cassette or End-of-Tape on paper tape 
prior to detecting an END statement), then the following 
applies: | 


l. If DI is a paper tape device, a HLT 57B is executed; 
this allows the operator to mount the next paper tape 
of the source program. Press RUN to continue the assembly. 


2. If DI is cassette, the same HLT 57B considerations apply. 
However, upon detection of the END statement (interpass 
rewind) the Assembler will initiate a rewind, wait for 
rewind completion, then issue a HLT 57B,C (103057B instead 
of 102057B); this informs the operator to turn the cassette 
over and position it to the begining of the source program. 
-An Assembler Control Statement C option (call for CROS) is 

treated the same way (interpass rewind). 


3. If DI is a disk logical unit, no halts occur; the Assembler 
assumes that the various Source Section files have been 
Queued on DI prior to calling the Assembler. 


The control statement errors "CS" and "R?" are printed on PL (in 
addition to HL if it was chosen in the assembler call) and a new 
control statement is accepted from PK. If the original statement 
was from the source program (DI), then the "I" option of the 
assembly call is forced (see Pl parameter description). 


The Floating Point instructions FIX and FLT can be used even 
though the Floating Point hardware is not available. The Non-EAU 
and EAU Assemblers generate calls to library functions IFIX and 
FLOAT, respectively, and automatically provide for the external 
statement linkages (as they do for FDV, FMP, FAD, and FSB). 
Except for speed, the differences between the Non-EAU/EAU 
Assemblers and the Floating Point Assembler are transparent to 
the user. 


In order to use the EAU shift-rotate instructions (ASR, ASL, LSL, 
RRR, RRL, and SWP) the EAU hardware must be available; the Non-EAU 
Assembler does not recognize these instructions. 
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The RAM instruction. (not mentioned in most HP documentation), 
which is used for. executing user's microprograms, is implemented 
in all versions of FDOS assemblers. | 


VII.C. CROSS-REFERENCE TABLE GENERATOR 


This program is a modified version of the Hewlett-Packard Cross- 
Reference Symbol Table Generator program 24109B. It uses DI | 
for input of the source program and offers a choice of list 
output to HL or PL. Listing uses PL if the P option is specified 
during the call. | | 3 


The Cross-Reference Table Generator recognizes several options 
specified by the contents of certain cells in the parameter 
area of the communication region. If the program is loaded | 
using the Executive program, these can be set by a call of the 
form: . 


RU CROS,,P1,P2,P3 


If the Executive is not used, Pl through P3 must be set into 
cells PARAM+1 (X7525B) through PARAM+3 (X7527B). Numbers must 
be entered as their actual values, while letters are represented — 
by their 7-bit ASCII codes. Missing parameters are set to Zero. 
The parameters are interpreted as follows: 


P1:K = accept a range of characters from PK, and do a 
cross reference table of all symbols whose 
initial characters fall into the character 
range included between the two characters typed. 
Otherwise, do a table of all symbols. 

Liew Onyottin, Mage fest chert. 
P2: ‘The number, counting from 1, of the file on DI 
to be processed. 4 ee 


P3:P = write output to PL. Otherwise, use HL. 


If the Cross-Reference Table Generator program is to be called 
automatically when the C Assembly Control Statement option is 
specified, it must be on the system disk (if the Executive is 
used) with the name CROS. In the case of an automatic call 
from the assembler, Pl is cleared, and P2 and P3 are as they 
were specified for the assembler. : : 
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VII.D. DEBUGGER 


Lidl. 


The interactive debugger program (DEBUG) supplied by Dicom is 
used to interface with machine language, SIO-oriented, user 
routines as an aid in debugging. DEBUG provides for an active 
breakpoint within the user's routines. The accumulators (A and 
B registers) and memory can be examined and modified from the 
console device TTY (either the standard HP-interfaced tele- 
printer or "deck zero" Teletype/CRT) after a breakpoint has 
occurred. 


When the breakpoint (that has been inserted in the user's program) 
is encountered, DEBUG is entered via a jump through location 4B. 
Upon entering DEBUG via the breakpoint, the contents of the A, 

B, Overflow, and Extend Registers are saved; thus these registers 
can be restored by DEBUG when returning to the user's routine 

via the Proceed or Run Commands of DEBUG. When entering DEBUG 
via the breakpoint, the breakpoint address and the values of the 
A and B registers are printed on the console device; at this 
point DEBUG can be used to examine memory locations, dynamically 
"patch" the user's program, establish a new breakpoint, and 
re-enter the user's program. 


DEBUG commands are single keystrokes (usually letters) pre- 
ceded by an argument when applicable. The argument defines 
a memory address. The commands recognized by DEBUG are 
described below. 


DEBUG COMMANDS 


N/ Print contents of location N. Location N is then 
open, SO an octal number followed by RETURN or 
LINEFEED will cause that number to be stored into 
location N. If no number is typed before the 
RETURN or LINEFEED, location N is not modified. 


NN; Print contents of location (N+offset). This 
location is now open, as above. 


/ Reopens location N. 

: Reopens location (N+offset). 

LINE Close current location (N or N+offset), changing the 
FEED contents if a number was typed before the LINEFEED, 


and open next by typing 
(N+1)/ XXXXXX 
or (N+1); XXXXxXX 
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RETURN Same as LINEFEED, except that the next location is 
not opened. 


4 Same as LINEFEED, except that the previous location, 
rather than the next, is opened. 


O/ Examine and open the A-register location. This 
location is set to the value of the A-register on 
each entry into DEBUG, and it is used to set the 
A-register before transferring control in response 


to P or R. 
1/ Same as @/, except for the B-register. 
B : Examine and open breakpoint. A value of zero 


indicates that there is no breakpoint. A non-zero 
breakpoint causes a JSB 4B,I to be placed in the 
location specified just before the DEBUG transfers 
control in response to P or R. (N.B. Location 4B 
is used as a pointer). A breakpoint can not be 
used on multiple-word instructions. 


E Examine and open the E and O location. This location 
is set to the values of the Extend and Overflow 
registers on each entry into DEBUG, and it is used to 
set them before transferring control in response to 
P or Rf The format of the word is: E=bit 15; 

O=bit g. 


I Examine and open the location specified in bits 
14-9 of the contents of the last location opened. 


J Examine and open break pointer location. 

NL Relocate DEBUG by a multiple of 29GB, so that it 
resides on the memory page containing location N. 

M Examine memory referenced by last contents. 

P Proceed from a breakpoint. When a breakpoint has 


been inserted into a program at location XXXXX and 
the program reaches that location, the debugger 
prints. 

XXXXXB aaaaaa bbbbbb 


Where aaaaaa and bbbbbb are the contents of the A- 
and B- registers. The operator can now use DEBUG 
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NP 


NR 


NS 


NT 


commands to modify memory locations (including 
XXXXX), move the breakpoint, change the values 
of A,B,E, and 0, etc. If it is then desired 
to continue execution of the program, the P 
command is used. 


If the breakpoint has not been moved, then P 
cannot be used if XXXXX contains a JSB to a 
subroutine which expects an argument ina 
location relative to the location of the JSB, 
or which has a return to any location other 
than one of the two locations following the JSB. 


Proceed from the breakpoint N times. 


Run from location N. A,B,E,and O are set and 
control transfers to location N. 


Proceed from the breakpoint, but suppress break 
message. 


Proceed from the breakpoint N times, but suppress 
all but last break message. 


Trace - move breakpoint to location N and pro- 
ceed from the breakpoint. 


Examine and open the offset register. This is 
the offset used in connection with the semicolon. 


STARTING DEBUG 


The debugger is called via the Executive by 


RU: DEBUG. Pin PZ 


where: Pl is the channel number of the teletype (octal 


' followed by B) or CMTS for deck zero (octal with the 


high bit set followed by B). If not specified, the 
default value is 12B. 


P2 is the page to which the debugger is to relocate 
itself after start-up (using its "L" command). If 
not specified, no relocation takes place. 


If loaded without the Exec, parameters must be set or 
cleared. 


RECONFIGURING DEBUG 


If it is desired to.change the default value of the 
debugger console, set location @88201B to the desired 
value (high bit set if CMTS deck zero), remove the 
write protect tab from the system disk, and type: 
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TQ D1, DEBUG; TQ D2, DEBUG; VE D1,D2,0,BA; 
SA D2, 201,, 420; WE D2 


VILE. FDOS FORTRAN COMPILER 


The FDOS FORTRAN package consists of modified versions 
of the Hewlett-Packard FORTRAN pass one and pass two 
programs (HP 20548A). Pass two is supplied in two 
versions; Floating Point/EAU(FOR2E) and Non-EAU(FOR2N). 
The package uses DI for source input, SC for interme- 
diate-tape storage, DP for binary output, and offers a 
choice of list output (if requested) to HL or PL. 


FORTRAN recognizes options specified by the contents of 
certain locations in the parameter area of the Communi- 
cations Region. If FORTRAN is loaded using the Execu- 
tive program, these can be specified by a call of the 
form: 


RU FORT,,PL,P2,P3,P4 


If the Executive is not used, parameters Pl through P4 
must be set into cells PARAM+1 (X7525B) through PARAM+4 
(X7538B). Numbers must be entered as their actual values, 
while letters are represented by their 7-bit ASCII codes. 
Missing parameters are set to zero. The parameters are 
interpreted as follows: 


Pick 
T 


accept control statement from PK; 

ignore first statement of the source program 
(assumed to be the control statement) and 
accept control statement from PK; 


If Pl is any character other than I or K, 
the control statement is expected to be the 
. first statement of the source program. 


P2% the number, counting from one, of the file 
on DI to be compiled; if not specified, — 
defaults to compiling the first file. 


P3:P = write all listings and symbol table (if 
requested in control statement) to PL; 
otherwise use HL. 

NOTE: If HL used and it is a disk logical 
unit, a file must be queued on HL even though 
no listing or symbol table is requested; 

this is because HL must be capable of re- 
ceiving any error messages, etc., that are 
generated. 


P4H:E = use Floating Point/EAU version of pass two 
(FOR2E). 
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X = use FOR2X or FOR2F version of pass two; 
or F these names have been included in order to 
accomodate user-supplied (or future) versions 
of pass two. 


If P4 is any character other than E, F, or X, 
the Non-EAU version of pass two (FOR2N) will 
be used. 


The compiler control statements consist of "FTN" followed by 
one or more of the following: 


,A Produce Assembly level listing (Pass two) 
,B Produce Relocatable Binary 
,L Produce source listing (Pass one) 


,<t Produce Assembly level symbol table only 
(Pass two). 


The FDOS FORTRAN Compiler called is stored on disk in two files: 
pass one (FORT) and pass two. FORT performs an initial pass 
over the source program, converting the FORTRAN statements into 
an intermediate binary form. This intermediate binary file is 
written onto a scratch file (the first file on SC is used), 
which is read by pass two and translated into standard relo- 
catable binary format. 


To Operate FORTRAN, the user must Queué the FORTRAN source 

program in DI, Queue a file for the relocatable binary as the 

next file on DP, Queue a file on SC for the intermediate-tape, and 
Queue a.file.:on’HL.(if required).. .If;iHL..is specified.:for: list 

and HL is a disk logical unit, a file must be available (even 
though no listing is requested; see P3 description); if this 

is not done, the compiler will halt with an "End-of-tape in 
wWwrite"(HLT 66B, see Section IV.C.1). 


A scratch file must be queued as the first file on the scratch 
unit (SC). This scratch file can be left on the disk, where 
it will be used each time FORTRAN is run, or it may be deleted 
after FORTRAN is run. FORTRAN will run faster if the seratch 
file already exists on the disk, so it is wise to simply leave 
the temporary file on the disk. 


After the files have been queued appropriately, the user types: 


RU FORT 4Pi,P2,P3524 
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When the program comes into memory it positions DI and ejects 
a page on the list unit (just a "thunk" on PL if the Form Feed 
option is in effect). Then it waits for the user to type the 
control statement if the Pl =*K or I. The compilation is then 
performed, and the program returns to the FDOS Executive by 
transferring to the System Loader (X754@B). 


DISK UTILITY PACKAGE 


The FDOS Disk Utility Package (DUP) was designed primarily to 
duplicate disks. It is structured to copy and/or verify ona 
track for track basis (instead of being sector oriented as is 
the rest of FDOS). This approach results in a significant 
saving of time; it takes approximately forty-five seconds to 
reproduce (copy and verify) an entire 131K word disk using 
DUP, vs. two and one-half minutes using a sector for sector 
basis. 


DUP is not part of the Executive, since DUP requires 4K of 
memory (two tracks) for buffers. 


When DUP is called, command information is passed via the 
standard parameter scheme. If DUP is called using the 
Executive program, these can be specified by a call of the 
forms 


RU DUP,,P1,P2,P3,P4,P5,P6 
If the Executive is not used, parameters Pl thru P6 must be 
set into cells PARAM+1 (X7525B) through PARAM+6 (X7532B). 
Numbers must be entered as their actual values, while letters 
are represented by their 7-bit ASCII codes. Missing parameters 


are set to zero. The parameters are interpreted as follows: 


Pl: command; C (copy), V (verify), or R (reproduce- . 
copy and verify). 


P2: source disk drive (SDISK); D,E,F,G, or S. 


P3: destination disk drive (DDISK); D,E,F,G, or S. 
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P4:; initial disk address (FSECT). 
P5: final disk address (LSECT). 


P6: target disk address (TSECT; initial sector 
on destination disk drive). 


NOTE: Parameters entered for sector addresses are treated as 
decimal values unless followed by "B". 


Default values for the parameters are: 


Pl (CMD) - =R 
P2 (SDISK) = S 
P3 (DDISK) =E 
P4 (FSECT) = @ 


P5 (LSECT) = FSECT if FSECT is specified, 
else use 1777B. 
FSECT 


P6 (TSECT) 


If "D" is specified for either SDISK or DDISK, then when DUP 
is loaded it types 


DISKS READY? 


to allow the operator to place the desired disks in the drives. 

A response of "Y" initiates the specified command. A response of 
"xX" causes an Executive reload via a transfer to the System 
Loader. Defining SDISK as "S" (meaning a "system" disk) causes 
drive "D" to be used, but DUP skips this question. 


When DUP has completed processing the specified command it types 


DONE 
SYSTEM READY? 


to allow the operator to exchange disks. A response of "A" 
(again) causes DUP to repeat the specified command; a response 
of "Y" causes the Executive to be reloaded via a transfer to the 
System Loader (NOTE: a "system" disk must be installed in 

drive D). 
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If DUP is called using defaults for all parameters (RU DUP) 
the disk in drive D is duplicated (copied and verified) onto 
drive E. DUP communicates using the Console List and Console 
Keyboard (CL nad CK) units. 
ERRORS : 
If the parameters entered are in error, DUP types 
ILLEGAL REQUEST 
San reloads the Executive via a transfer to the System Loader. 
If an error is detected during verification, DUP types 
COMPARE ERROR 
and proceeds to the "SYSTEM READY" question. 
If bit 15 is set between transfers, then DUP types 
ABORTED 


-and proceeds to the "SYSTEM READY" question. 


All device errors cause SIO/XIO halts; see Section IV.C.1. 
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‘VIII. FDOS BCS PACKAGE 


In addition to the Basic Control System Drivers provided, other 
programs are needed to allow the Hewlett Packard computer user 
to take full advantage of the FDS in a BCS environment. The 
FDOS BCS package provides disk I/O facilities during the Pre- 
pare control System process. It also provides console device 
interaction, I/O capabilities, and an interface with the SIO 
Driver package (and, consequently, with the entire FDOS system 
if desired) during the loading process. 


The FDOS BCS package contains the following modules: 
*Disk Prepare Control System (DPCS), absolute binary 
*Tnput/Output Control (.1I0Cc), relocatable binary 
*Teleprinter BCS Driver (D.@@%), relocatable binary 
*Cassette System BCS Driver (D.35), relocatable binary 
*Floppy Disk System BCS Driver (D.36), relocatable binary 
*FDOS Relocating Loader (RLOA), relocatable binary 
*Subroutine Library, relocatable binary 

In addition, a configured BCS file (ABCS, Absolute Basic Control 

System) is provided; this file was built using the above modules 

and hardware configuration in Section V.A. 


7IIIT.A. DISK PREPARE CONTROL SYSTEM 


The Disk Prepare Control System (DPCS) is a modified version of 
the standard Hewlett Packard Prepare Control System (PCS). 

DPCS processes relocatable modules of the Basic Control System 
and produces an Absolute Basic Control System file (ABCS) that 
is configured to work with a specific hardware configuration. 

It creates operating units of the Input/Output Control subroutine 
(.20c), the equipment driver subroutines (BCS Drivers), and the 
Relocating Loader (RLOA). It also establishes the contents of 
certain locations used in interrupt handling. Options are 
available to define the equipment driver modules and other BCS 
system subroutines as relocatable programs to be loaded with the 
user's object program. 


DPCS is an absolute program which runs in the SIO environment 
using the configured SIO Driver (see Section V). The order in 
which the BCS modules are loaded and processed by DPCS is not 
significant, except that the disk BCS Driver must be the first 
module loaded and the FDOS version of the Relocating Loader 
must be the last module loaded. Two modules, the Input/Output 
Control subroutine and the Relocating Loader, require that 

the parameters be entered via the keyboard after being loaded. 
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The EQT input of IOC has been modified in two ways to handle the 
D.36 driver: first, the Unit Number can be one or two digit 
octal value in the range § to 37; secondly, another input follow- 
ing the Unit Number has been added which defines the offset 
between the disk data channel and the disk control channel as 

a "C" followed by a one or two digit octal value in the range 

1 to 17. Thus, the Equipment Table Statement is of the form: 


nn,D.ee(,D) (,UuC(u)) (€,Colo)) 


The first word of the EQT has been changed to assign bits 18 thru 
06 to the Unit Number (instead of bits 88 thru 86), and to assign 
bits 14 thru 11 to the disk control channel offset. These added 

bits (14 thru 69) were previously unused. 


In addition to the above changes, all loader diagnostics and 
completion of DPCS cause a reload of the Executive (via a 
transfer to the System Loader, X7544B). 


DPCS is an absolute program which runs in the SIO environment ; 
it uses the SIO Driver to load the various BCS modules from 
DI and to write the configured BCS file (ABCS) onto DP. 


Since the SIO Driver has been configured for the I/O aspects 
(see Section V.A.), most of the initialization phase of HP's 
PCS is not required in DPCS. It should be noted that DPCS can 
be used to prepare a BCS system for a hardware configuration 
different from the one that DPCS is being run on. This is 
possible because the ABCS file is not built in core, but on 
the disk. 


To operate DPCS, proceed as follows: 


1. Since the BCS Drivers to support a hardware configuration 
defined in Section V.A are Queued on D3 of the "skeleton" disk 
shipped from the factory, it is only necessary to reassign DI 
to this unit prior to calling DPCS. This, along with obtaining 
a list of the modules that will subsequently be processed by 
DPCS, is accomplished by typing: 


AS DI,D3;LD Dt 
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The Executive responds by typing 


D.36 
D.36X 
D. £9 
D.35 
. roc. 
RLOA 


If additional BCS Drivers are to be incorporated, they should be 
copied to disk and Queued to Dl preceding RLOA. 


2. Open a file on DP to receive the ABCS file generated by DPCS, 
and call DPCcS by typing 


QU DP,ABCS;RU DPCS 
NOTE: Following this section is a sample dialog of DPCS. 
3. DPCS will be loaded, and will type 

FWA MEM? 
requesting the first word of available memory, i.e., the first 
word in the base page following the locations required for in-- 
terrupt processing; this word. defines: the¢startcof -the BCS: system 


linkage area. Here, as with all subsequent addresses requested 
by DPCS, reply with an octal number. 


4. DPCS will type 

LWA MEM? 
requesting the last word of available memory. This word is 
usually the location prior to the protected area (e.g., X7677B), 
or the location prior to the FDOS System Loader (X7533B) so that 


the BCS system may interact with the System Loader (and there- 
fore, the entire FDOS if desired). Reply appropriately. 


5. DPCS will type 

SYS RST? 
requesting the system restart address to be used by BCS when 
returning to the SIO environment via the System Loader. Use 


X7544 (cold start) since SIO and BCS use different in-core 
- buffers and. tables. ; 
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6. DPCS will type 
*LOAD 


informing the operator that it is ready to process a BCS module 
from the system Input unit (DI). The modules may include .IOC, 
the various BCS drivers, and the Relocating Loader (RLOA). To 
cause a module to be loaded, strike any key on the keyboard 
followed by Return-Line Feed. The "*LOAD" message is repeated 
after each module is loaded until RLOA has been processed. 
Diagnostics are printed if certain error conditions occur during 
the loading. 


The absolute lower and upper bounds of each module within BCS 
are listed after the module is loaded. The format is as follows: 


MODULE NAME 
11111 uuuuuu 


NOTE: For details of Input/Output control (.10Cc) and the 
Relocating Loader (RLOA) operation, the user should 
refer to the Hewlett Packard BASIC CONTROL SYSTEM 
manual, P/N 02116-9017; to A POCKET GUIDE TO THE 
2100 COMPUTER, or to A POCKET GUIDE TO HEWLETT- 
PACKARD COMPUTERS; or to A POCKET GUIDE TO INTERFACING 
HP COMPUTERS. 


7- When .I0C has been loaded, DPCS requests the information 
needed to construct the Equipment Table (EQT), the Standard 
Equipment Table (SQT), and to define the Direct Memory Access 
Statement. Refer to the dialog following this section for 
examples of these. 


8. When RLOA has been loaded, DPCS requests the parameters 
needed to set the interrupt linkages for input/output processing; 
for examples, refer to the dialog following this section. When 
these have been supplied, DPCS goes on to Processing Completion; 
the final step in DPCS processing is the writing of the Absolute 
Basic Control System file (ABCS) on the system Output unit (DP). 
When this is completed, control is returned to the FDOS Exec- 
utive via a transfer to the System Loader. 
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VIII.B. FLOPPY DISK SYSTEM BCS DRIVER, D.36 


The FDS BCS Driver (D.36) is a relocatable driver operating in 
the interrupt environment which accesses the disk data in the 
same format as does the SIO Driver. D.36 accepts commands and 
returns status in the standard form expected by the Input/Output 
control program (.I0C). This driver is not designed to be used 
with the Hewlett Packard Buffered IOC, since that program cannot 
assure the sixty microsecond interrupt response time required 
by the FDS. 


8% 
foo 


A separate BCS module, D.36X, is also provided. This module 
contains the Logical Unit Parameter Tables and Buffers for D.36, 
which D.36 refers to with externals to determine how many buffers 
are available and how many drives are to be supported. The 
source (SD36X) of this module is also provided so that the user 
can edit the module to any unique requirements.' 


The commands on the following page are accepted by the driver. 
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es) 
ct 


ed 
Pe PT PS PS PT OT PT OS OPT OP PTR OE OB 

HW 

Q 


un 
oO’ 


FRE QAM MMM M M10 RQ 


Operation 
CLEAR REQUEST 


READ ASCII RECORD 
READ BINARY RECORD 

READ VARIABLE BINARY RECORD 
WRITE ASCII RECORD 

WRITE BINARY RECORD 

WRITE END-OF-FILE 

SKIP ONE ASCII RECORD 

REWIND 

SKIP TO END-OF-FILE 

SKIP ONE VARIABLE-BINARY RECORD 


} cE QRBRRAE 
PRE RP RP RFR QQQeaw FF 


QARQQaQQQaQQAA 
PRPRPrPRrPRQRFEFE RINE 
PPS PP PT PO OM OOO 
Pi Pt OP Od OO OO PTL TR 
FRrRRQRrFOQK ME MM MIN Q 
PRQarrFRrPRBRrFFUM 


Z 
Oo 
tj 
te 


: A read record command with a buffer address of zero 

- will produce a skip-one-record of the designated type 
.(i.e., ASCII, binary, or variable binary). All other 
commands are rejected by the driver. 


The following status returns are generated by the driver: 


Bits 
76543219 Meaning 
lLxxXxXxXxXXX _ END-OF-FILE DETECTED 
ke Se Oe REWIND JUST EXECUTED (AT BOT) 
xX LxXxXxX xX xX END-OF-TAPE ON READ, DISK FULL ON WRITE 
X XX1lxXKXXX WRITE ERROR (OTHER THAN WRITE PROTECTED) 
xx XS bx XX BROKEN TAPE (SECTOR CHAINING IN ERROR) 
xX xXXXX1KX WRITE PROTECTED 
Xx XKXXXX Lx READ ERROR 
xX XR XX KL DEVICE BUSY OR NOT READY OR INOPERABLE 


Bit 14 of EQT word 2 is set for read errors and write 
errors other than write protected. 


The Driver returns to .I0C. with the following conditions: 


S B Meaning 

GBPHB OPERATION INITIATED, IN PROGRESS 

GGG OB OPERATION EXECUTED AND COMPLETED 

GG GB ILLEGAL FUNCTION WAS REQUESTED 

CGC GO DRIVER OR DEVICE IS BUSY OR NOT READY 
OR A "BROKEN TAPE" CONDITION EXISTS 


If the EQT is incorrectly configured, i.e., illegal Logical Unit 
number or the DMA state from EQT does not match DMA state of the 
driver, then the ***FATAL*** halt at "IOERR" (in.IOC) will occur, 
with A = 3 (for misconfiguration) and B = absolute address of the 
"JSB »IOC". | 
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VIII.C. DISK DATA I/O DURING BCS OPERATION 


Since the disk is a file-oriented device, and since D.36 has 
file-manipulation capabilities, the disk can be thought of as 
amag tape. Thus, a user program can store and retrieve data « 
on disk by using the FORTRAN Auxilary Input/Output Statements 
of REWIND and ENDFILE as an example. However, prior to doing 
disk I/O, the file or files must be "opened" on the appropriate 
disk logical unit (the Unit Reference Numbers defined in the 
EQT during DPCS) and the Logical Unit Directory set up; this is 
analagous to mounting the mag tape. 


This "opening" of files and LUD set up can be accomplished via 
the Queue command of the FDOS Executive prior to calling the 
user program. It may also be appropriate to use the Reserve 7° i= 
File command to reduce the amount of head slewing (see QU and 
RF command descriptions in Section VI). 


During some application programs it may be desirable to have 

the same file Queued on both the Output Unit and the Input Unit. 
Thus, the user program could output an array, "close" the file 
(ENDFILE), reposition the file (REWIND), then input and process 
the array. 


A note of caution is appropriate here. The .IAR. routine of 

the standard HP formatter reads data in fixed blocks of 120 
characters (60 words) during an Unformatted Read. Thus, calls 
must be in multiples of 60 words, or input data will be lost 
(i.e., if 50 was requested, words 51 thru 60 would go to the 
"bit bucket"). Also, during Unformatted Read, the total number | 
of words requested must be a multiple of 60. 
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VIII.D. THE CASSETTE SYSTEM BCS DRIVER, D.35 
D.35 is a relocatable driver for the cassette system. It 
accepts commands and returns status in the standard form expected 
by the Input/output Control program (I0Cc). This driver is not 
designed for use with Hewlett-Packard Buffered IOC, since that 
program cannot assure the 2 ms interrupt response time required 
by the cassette system. 


The following commands are accepted by the driver: 


Bits 15 -— 12 . Operation: 
0 Clear 
1 . Read a record 


Bit 6 = 1 for binary, @ for ASCII 


2 Write a record 
Bit 6 = 1 for binary, @ for ASCII 
3 control function: 
Bits 8 - 6 Function: 
1 Write End-of-File 
3 Skip one record 
4 Rewind 
6 Skip to end of file 
7 Skip one record 


Any other commands are rejected by the driver. 


The following status returns are generated by the driver: 


Bit Meaning: 
Z End-of-file detected during read 
6 Leader detected after rewind 
5 Leader detected after operation other than 
rewind 
4 Write command rejected, but not for- write 


protected cassette 


3 Not Used 


ViIIT=-8 


2 Write protected cassette 
1 Error detected during read 
g Device busy (not ready) 


End of tape status (Bit 5) can only be cleared by issuing a 
rewind command. Read error (Bit 2) and write commands rejected 
for reasons other than write protected cassette (Bit 4) cause 
Bit 14 of EQT word 2 to be set. 


VIII.E. THE ABSOLUTE BASIC CONTROL SYSTEM FILE 


The Absolute Basic Control System file (ABCS) was built with - 
DPCS and the hardware configuration defined in Section V.A. 
The following differences exist between the Relocating Loader 
module (RLOA) of this file and the standard Hewlett Packard | 
Relocating Loader: 


*Interaction is via the console device rather than 

the Switch Register 

*A11 loader diagnostics cause a return via the System 
Restart Address (see Section VIII.A.5). 

*The subroutine library is a file named LIBN, LIBE, 

LIBF, OR LIBX Queued-on the library unit D4. 

*after writing an absolute binary file, or in response to 
a HALT call, ABCS executes a JMP to the System Restart. 
Address (see Section VIII.A.5). 


When ABCS (of which RLOA is a module) is loaded, the message 
"*kOPT" is typed on the console device. The user must respond 
with one or two characters as follows: . 


"p" requests writing an absolute binary file on the 
system Output unit (Unit-Reference no. 4, normally E2), 
followed by a file (on the system Output unit) containing 
the entry point list; if a second file is not Queued 

on the unit, the entry point list is lost. 


"TZ" requests printing a bounds list on the system list 
device (Unit-Reference no. 6, normally E3). All other 
characters have no effect, except that they are counted 
(e.g., "Q" signifies to the program that no options are 
desired). 


Whenever an end of tape condition (e.g., a File Mark) is 
encountered, the program types "*LOAD". At this point the 
user must type one character (D,F,I;N,T,E-or x); and may 


type "L" if. desired. 
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These have the following meanings: 
I = Load another file from the system Input devi 
defined in SQT). - J ee Nae 
D = Proceed to the end-of-loading phase. 
T = Terminate loading. 


N = Load from LIBN (Non-EAU Library) . 


E = Load from the LIBE (EAU Library). 


F = Load from LIBF (Floating Point Library). 

xX = Load from LIBX (User-supplied library) . 

L = (with any of the above) Produce a bounds list on the 
system list unit (Unit-Reference no. 6, normally E3); 
if a file is not Queued on the list unit, the bounds 
list is lost. 

At the end-of-loading, the program types ""*LST". The user 


must type one character: 


L = Produce an entry point list on the console list 
device (Unit-Reference no. 2, normally the teletype) 


Any other character = Do not produce an entry point list 
on the console device 


Upon completion, ABCS prints the "*END" message, and reloads 
the Executive via a transfer to the System Restart Address 
(normally the System Loader "cold start", X7544B). 


VIITI.F BCS DEBUGGING SYSTEM 


The debugging routine provided by Hewlett-Packard as part of 
the standard BCS package is fully compatible with the FDOS BCS 
package. The user is referred to the Hewlett-Packard BASIC 
CONTROL SYSTEM manual, P/N 02116-9017, for integration and 
operation instructions. 
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VIII.G. SAMPLE DIALOG FOR DPCS 
*AS DI»D3 Logical Unit D3 is Assigned to DI. 
*LD DI A Logical Unit Directory for DI is 
D3: obtained to show which modules will 
De34 be processed by DPCS. 
De 3AX 
De AA 
De35 
LOC. 
RLOA 
*OL! DPs ARCS - A file is opened on DP to accept ABCS. 
— *RU DPCS DPCS is called. 
FWA MEM? | The First Word of Available memory, the 
es Last Word of Available memory, and the 
LWA MEM? System Restart address is defined. 
27533 
SYS RST? 
P7544 
-*& LOAD DPCS is ready to process modules; "Z" 
Z | (or any character) directs it to load. 
De 36 | The FDS BCS Driver is loaded and its 
25365 27533 bounds listed. 
* LOAD 
Z 
De 36X The FDS BCS Driver's "externals" module 
P4716 25364 is loaded and its bounds listed. 
* LOAD 
Zz ° 
Daa The teleprinter BCS Driver is loaded and 
24162 24715 its bounds listed. 
* LOAD 
Z 
De35 The cassette system BCS Driver is loaded 
P332A PAl4l and its bounds listed. 
* LOAD 
Z 
1OC IOC is loaded and its bounds listed. 


P31AL 23317 
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SAMPLE DIALOG FOR DPCS (Continued) 


* JARBLE FNTRY 
Unit- 


Reference 
Number 


EQT? 
105D-36sUG5C1 © 7 
102D+362U1-C1 1g 
105D-36,U2.C1 ll 
10sD-365U35C1 12 
105D-36sU4sC1 13 
145D-365U5sCl 14 
-102D-+362U6sC01 15 
192D-36sU72C1 16 
125D-00 » aie 
14:D-352U8 sso 
145D-35,U1 21 
145D-355U2. 22 
14,D-355U3 23 
ZE 


-PUNCH? 
15 
~INPUT? 


LOADR . 
20345 23905 


INTERRUPT LINKAGE? 


102051-36 
LisllsC<36 
1252251-80 
132187013 
1492451 +35 
JE 


The Equipment Table is defined; Logical 
Unit D4 becomes EQT entry 7, D1 becomes 
1%, D2 becomes 11, D3 becomes 12, E4 
becomes 13, El becomes 14, E2 becomes 
15, E3 becomes 16, cassette deck zero 
becomes 29, deck 1 becomes 21, deck 2 
becomes 22, deck 3 becomes 23, and the 
teleprinter becomes EQT entry 17, 


Unit-Reference numbers are assigned to 
the units in the Standard Equipment 
Table. The Library will be D4, system 
Output (PUNCH) will be E2, system Input 
will be El, and High-speed List (LIST) 
will be E3. 


No Direct Memory Access channels are 
available. 


The Relocating Loader is loaded and its 
bounds listed. 


The Interrupt Linkages are defined for 
channels 19, 11, 12, and 14; since no 
BCS Driver. was included for the device 
in channel 13, a halt will be executed 
if an interrupt occurs on channel 13. 
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SAMPLE DIALOG FOR DPCS (Continued) 


“SQT-. PRAKE 
oFOTe P3A14 
C+36 ° 2A4AS 
Ne 3A P5646 
DICOM 25365 
T2326 26431 


RFTRY 26345 °: 
“RUFS 25322 . 


eLUPT 252324 
-STRL 24717 
IOFRR 23275 
NBUFS 47164 
NLOGU 25323 
DAM 24162 
T.AA 24336 
eRUFR 232047 
De35 23328 
1-35 23757 
-10Ce 23181 
DMAC] 23316 
DMAC2 23317 
XSQT 23314 


XEOT 23315 


LST 20376 
e-LDRe 22001 
“MEM. 22777 
HALT 22774 


*SYSTEM LINK 
AAB2S Aran 


*7S53RS 
+ 


A list of the entry points is printed. 


The bounds of the System Linkage area 
are printed. Upon completion of the 
writing of the ABCS file to DP, the 
Executive is automatically reloaded. 
Note that ABCS is built on disk, not 
in core. After returning to the 
Executive, we zero out the system and 
restore the I/O assignments. 
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ape ees 


COMMAND 


Add to LUD. 
Assign. 
Batch. 
Batch Exit. 
Comments. 


Copy. 


Directory. 
Directory with 
Addresses. 

Delete. 

Dump Disk. 
Dump Memory. 
Dump Records. 


Dump Verify 
error records 


Format Disk. 
Go To. 

' If Disk. 
‘List. 


List Verify 
error records 

List All Units. 

Logical Unit 
Directory. 

Queue. 

Reserve File. 

Restore. 

Repeat Current 
Command line 

Rename. 

Rewind. 

Run. 

Run from speci- 
fied Disk. 

Save. 


Skip. 

Save Start 
address. 
Temp. Queue. 

Verify. 
Write. 

Write EOF. 
Zero System. 


CoO MMA N DS UM MAR Y 


FORM 


AQ 
AS 
BA 
BX 
kk 


co 


DI 


DA 
DL 
DD 
DM 
DU 


DV 


FD 


GO 
ID 
LI 


LV 


LA 


LD 
QU 
RF 
RS 


RP 


DUNT,NAM1,NAM2,... 
FUNT, PUNT, LCTR,PGCTR 
NAME 

NAME 

Text 
SRCE,DEST,#,MODE 


DISK,DEST 


DISK,DEST 

DISK, NAME 
DEST,DISK,LO,HI 
DEST, LO, HI 
SRCE,DEST,LO,HI,MODE 


DEST 


DISK 
ADDR 
UNIT 
SRCE,DEST, LO, HI 


DEST 
UNIT 


DUNT | 
DUNT,NAM1,NAM2,... 
DISK, NAME,+ 


# 


DISK, OLDN, NEWN 
UNIT 
NAME,SA,parameters 


DISK, NAME,SA, parameters 


UNIT, FWA, LWA 
UNIT, # 


UNIT,ADDR 

UNIT, NAME 

SRCE, DEST, +#,MODE 
DEST,SRCE 

UNIT 


DEFAULT CONDITIONS 


None. 


LCTR & PGCTR as before. 
NAME = next file on BC. 
NAME = next file on BC. 


N. A. 
SRCE: = DI, DEST = DP, 
# = 1; 


Dio i SHC hs 
DEST = CL. 
None. 


DEST = CL, LO = 


2, H 
DEST = CL, LO = 2, HI = 
= CL 


SRCE = DI, DEST 


MODE =:ASCII. 


Il 
be 
oO 


HI = EOF, MODE = ASCII. 


DEST = CL 


None. 

None. 

None. 

SRCE = DI, DEST =CL’, 
LO = 1, HI = EOP. 


DEST = CL 


UNIT = CL. 


None. 
None. 
None. 
N. A. 


= infinity (not 32K) 


None. 

UNIT =DI. 

None. 

None. 

UNIT = DP, FWA = 2, 
. LWA = FWA. 


UNIT =DI, # = 1. 


UNIT = DP. 
None. 


‘(same as Copy). 


DEST = DP, SRCE = CK. 
UNIT = DP. 
N. A. 


The following parameters are used with FDOS Executive commands: 


ADDR = octal address 

# = number of files or sectors to process, or number of repeats. 

DEST = any functional or physical unit 

DISK = D, E, F, or G (floppy disk drive) or logical units or func- 
tional unit assigned to disk. | 

DUNT = Dl, D2, D3, D4, El,...,G4 (logical units of DISK) 

FUNT = functional unit 

FWA = first word address 

HI = last record or address to be Seecetead 

LCTR = page-spacing line counter 

LO = first record or address to be processed 

LWA = last word address 

MODE = mode of data; A (ASCII), BA (absolute binary),: 


or B (relocatable binary) 


NAME = name of a disk file 

PGCTR = page-spacing character 

PUNT = physical unit 

SRCE = any functional or physical unit 
UNIT = any functional or physical unit 


Se Seles ee 


NOTES: Any number input which defaults to octal (disk and core 
addresses, etc.) can be followed contiguously by "I", which sets 

bit 15 before further processing. This is useful with the GO 

command; for example, to transfer indirect to the (core resident) 
DEBUG breakpoint entry use "GO 4I". 

DISK or DUNT values can be referenced implicitly or explicitly via 
Functional Units, Physical (disk logical) Units, or disk drive letters. 


FAGE 


UQ3C* 
UO31 
OUS2 
UUSS 
VVS4 
yv0Q35 
OUG4&+4 
JOST 
VOSE 
V039 
LU4D 
UO4] 
VUGS 
VOUS 
QO044 
U4» 
UU4o> 


CCCS #074 


CGFeE Sleét 
1CecG 


10060 
STAFT CF 
N26 


CCEOU 


DIF RFEREWC 
OGAUU 


DiS. Sick. 


COFRF AblsG Disk SIZES 


=~ rk NORFAL, 12k LFF (Ck & MT) 

CEG LOLUGL 

IFé 

CRE 20UbUE 

x1F 

Curk Eu * 
BCCILOALER LOA ARCA Tiki EXEC. NEG/TIVE RELATIVE Te "CORE" 

CKGE 26k 


Fé 
Che 4eébbB 
Xt 


CUneS ELU x 


E bETBELN LOAD ARL EXECUTIChH ADUrESS 
COREG EGU CORE R-COntS-7E0UE 


(S &BYT POSITIONS) TRRELEVAWT 


PaGE CCO4 £U0i FOCS BUOOTLC,LER COmFicuRaTION 


UOGE fUCCI Sin Eeli t 

Q04S CUGUL - A EGU O 

uo50 cCbtG1 i Feu 1 

UU51 UlLzZ0U WSLCT E&t 128 

GO052 GUusio bel Ewti 105 

COS3 CuG3l1 De EGu 118 

vO54 C014 SeSK EGU T4E 

CU5S5s 

yv056é 07600 ORG CGRE-CORES 

UU57 U7EOU O&3666 COnFE LUA .LAIL SET COMFIGURATION PCINTE? 
UU58& 27601 O73664 STA LOPTK 

v059 76bEe luUeb74 HLT 74e EMTER DATA CHANEL 
U0ES O7e.03 OL7Es7 USE Sweun 

U061 7804 102075 HLT 75é: EhTER COMBANL ChAnNEL 
UU62 C7665 UL7657 JSR SCOR 

VUGZ C7606 16Z2076 HLT 766 LiABL LOADER 2 SFT. ¥7T7GF In S| 
U064 C7H07 1UzZ501 LIA Sih 

UU65 67610 013655 Blk: XPAGE KEEP PAGE 

‘U066 C7611 UT7ECCUI SiA & 

V067 C7612 064656 LUA «STRT GET CURRERT BOOGTLUACEF ChICTt. 
U06% C7615 G7SE57 STA FETCH SET SOURCE FTF 

Uu069 C7614 6135655 Abi XPAGE COMPUTE OFFSET 

0070 7615 UOSC04 ChAyIha 

CO71 G7E16 OFG061 “ALA R 

GU72 G7é17 G4365e6 AGA «STRT 

UVU7Z UTGe20 O736E6U STA STORE SET DESTIbATION PTR 
YU74H C7E2Z1 OLEOV4 Tia AND START 

0075 C7é22 GOZ004 Live 

JO76 7625 6735664 STA IGPTR 

UU77 C7624 Ge76el LEB LEOuT USc 2B AS LOGr IDE X 
0078 07625 103465 LCGP LLA FETCHel 

u079 C7é26 C57657 I$Z FETCH 

G0K0 27427 173660 STA STCREcI 

UU61 07440 037666 ISZ STGRe 

UVO8S C7631 OUH006 ING wyS2et GWE? 

U08% C7632 G2764e5 JUMP LOOP NO 

GO84 27643 102077 HLT 776 

UU8S 67464454 063665 LA SYSL 

0086 67535 102601 CTA Sik 

0087 G74636 127664 UMP ICPIReI 

VO088 27637 UUUOUU SiCON LOP 

0089 C764U 1025U1 LiA Swk GET CHAHREL 

UO90 G7é41 Vis662 AND CHAN, 

0091 C7642 073663 STA CHAN 

UO92 O744% 167664 CCNLF LUB ICPTReI GET NEXT /OR 

0093 67644 GS7664 ISZ ICFIR 

UVOS4 27645 0060U3 SZbekSS DOCNE? a 
0095 C7646 127637 JEP SWCONe¢1 YES 

VO9AR C7EY7 003662 LULA CHAN, 

VO97 O765U UGZOUE CRA 

0098 C7651 116001 ALO ByI CLEAR CHARNEL BITS 
0099 07652 053663 IGK CHAR PLT IN GESTRED Chan 
UV100 07653 17U0U1 ST’, Eal PLT IT SACK 

Q1U1 7654 C2764S- JEP CCNLP 

J1G2 


U1U3 07655 G76000 XFAGE CCT 7e00G 
0104 U7656 UU7700 ,STAIT GEE STAKT-CUREL 
PAGE 0005 ¢#Gl1 FCOS FUOTLOACER CONFIGURATION 


U105 C7657 GVEUGOCO FLTCr OF 


U1U4 
Ulu? 
Q10& 
01U3 
01190 
Q1i1 
vli2é 
G113-x 
91124 
U115 
G116 
Y11? 
U11LE 
G1l1iG¢~s 
Gi26 
Ulel 
Clee 
“12S 


C7660 OuGGOYU 
C7661 177700 
e7ééee UUUOTT 
C7r632 OLUOOG 
C7664 VUCO0U 
67o65 CuU0014 
C7666 Csl6e7 


OU775C 
OU7764 
CUT 7&AL 
UUTTA7 
VUGHUD 
"CRLELS" 
QuU7745 
GU77S1 
UuUT75z? 
UulJuUu 


C7S5E7 
L757U 
C7271 
C1E7! 
C7673 
LisT 

27674 
C7675 
CVE TE 
07677 


~ 


STORE 
LtoGT 
Cr Ale 
Craiv 
Lorde 
&YSuU 


evr Pe 


DATLS 


MUST 1M 


CreULS 


NOP 
O01 
CET 
NOP 
hut 
ABS 
bi F 


OF 
OLF 
DEF 
DL F 
OCT 


“100 
77 


eo eat 
VETLS=-COFRLL 


Ol. 7-COrhEb 
COR CUREL 
DL.9=COREL 
Ot e10=CuUREL 


\ TERE IMATE 


PEROLTATELY FOL Gw 


Ui F 
DEF 
Lit F 
CLT 


UC .1lU-CURcI. 
CC e144 COREL 
CC e15-CORLD 


U TERMINATE 


PAGE 


O125 


D126» 
u1l27 


U129 
01304 
v131 
Vise 
UV1lS3zZ 
V1LS4 
U135 
U136 
U1LS7 
0138 
0139 
V1l4C 
ULGL 
ULE? 
U1L4s 


ul44 


ene Leena ere Of 


U1L45 
UL4Y6 
v147 
0148 
V149 
0150 
VIS1 
0152 
U153 
B154 
Uu155 
J156 
V157 
O15& 
0159 
G160 


606 


C7700 


LoOab Flite 


C1 


° 


STAFTING AT SLCTOR 


FUCS &LOTLO/0ER 


see 


ChG CORE-COnES+1 008 


O77UU CUCEOIY START CLASS . 
Uiz&*LOAG FILC STARTING aT BLUCK SPCCIFIfi IN SkRITCH REG 


O77U1 


LGAD FILE STARTING AT ELOCK 


07702 


07705 


C7704 
O7765 
(7706 
G7707 
C7710 
C7711 
07712 
C7715 
07714 
G7715 
C7716 
C7717 
U7 7EU 
O7721 
C772e 
B77T235 
C774 
C7725 
O7T7E€ 


07727 


07-730 
07731 
07732 
C7733 
C7734 


07735 
el?1sé 


1u25a} 


OU74U0U 
O7777e 
033772 
O73777 
Or7 737 
027735 
Ov20US 
VeT TUG 
OU1727 
QUSOCH 
O7 3774 
Q17737 
lucO1l4 


“U7TGUUL 


OT4T7TD- 
Q17737 
162014 
644000 


LIST To. 


037775 
G37774 
027721 
Q1L7737 
102014 
eoc0ec.1 
O277U6 
luecdle 


067772 
O24001 


STARI 


STAKe. 


Re CNT 


NXOAT 


BCOTE 


Lla Swh 


CUB 
STE 
IGk 
STA 


ELKINT 
PKUCM 
MYSEC 
JS6 HCwhe 
JhP BOCTE 
S2AdRSS 
JEP RWCNT 
ALE «ALF 
ChAdINA 
STA WwWChT 
YS KCeRD 
HLT 146 
STA E 

STA PTX 
JSE RKCWRE 
HLT 14k: 
ALE A 

STA FTAeI 
rS2 1X 
1SZ wChd 
JiRP NXCAT 
JSE RCwKD. 
BLT L4i 
CPA E 

JUMP RECHT 
PLY bebe 


LOB PLT77 
JMP 


VileixSuBROUTINE TO CET A bkORD 


Ul62* 
ULE 
Ol6e4s 
01654 
J166" 
UL67* 
0168» 
01694 
J0170% 
O1lL71+ 
Ul724 
U1lL73* 
U174 
J175 
0176 
9177 
0i7& 
G179 
0186 
G161 
PAGE 


UlgEe 


1 IF PREVICUS SECTOR FULLY INRUT 
IS INITIALIZED 


2 LfvePoT 


27737 
C77HU 
O7 741 
C7742 
07743 
C7744 
C7745 
G7746 
oG07 


C7747 


nO 


THEN - 


ZOKC 


SPLCTFIEL 1K 


IWITIALI2¢ 
(MAKE FIRST SECTOR 


AM KEGISTEY 


TC REAL SFCTE:: 


PChefevt) 
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INTERFACE DESCRIPTION 


The model 422 Floppy Disk System (FDS) is interfaced to the 
Hewlett-Packard 21XX Series computers (2100, 2114, 2115, and 2116) 
via two identical interface cards (Dicom Part Number 520-50052- 
02). The interface cards can be installed in any two available 
T/O channel slots. The highest priority (lowest numbered) 

channel is used for data transfers; the other channel is used 

for command and status transfers. The FDS interface supports 
programmed I/O, interrupt environment, and DMA operation (16 

bit) 3 : 


Since the FDS is a block-synchronous device (data transfers 
must occur every sixty microseconds once initiated), a high 
priority should be used for the data channel when operating in 
the interrupt environment in order to avoid rate errors. 


An OTA (or OTB) instruction is used to transfer commands and 
data to the FDS; an LIA (LIB, MIA, or MIB) instruction is used 
to transfer status and data from the FDS. After executing the 
T/O instruction, control must be set and the flag cleared for 
that channel (select code); thus the proper sequence is OTA 
followed by STC,C; or LIA followed by STC,C. 


The POPIO line generates an initialize to the FDS; thus the 
FDS is initialized when the PRESET (or EXTERNAL PRESET) push- 
button is depressed. 


Following is a definition of the command and status bit assign 
ments for the FDS. 


COMMANDS (true when set in A/B before OTA/B) 


BIT NAME FUNCTION 

15 RESET Initilizes FDS; positions to 
track zero. 

14 WRITE Select write operation 

13 READ Select read operation 


NOTE: If bits 13 and 14 are both 
zero upon receipt of STC, no read 

Or write operation will be attempted; 
this allows selection of a unit for 
status testing. 


12 
and — 
Nate 


10 
thru 


04 


03 
thru 
00 


UNIT 


TRACK 


SECTOR 


Specifies unit number (unit D 
= 9, unit. E = #1, unit F = 1Q, 
unit G = 11) 


Specifies track number 


Specifies sector number 


STATUS (true when set in A/B after LIA/B) 


BIT 
15 


14 


L3 


12 


Li 
LO 


09 
thru 
00 


NAME 
NOT READY 
(DRIVE) 


FORMATTER 
NOT BUSY 
{FORMATTER 
READY) 


DATA 
ERROR 


WRITE 
PROTECT 


RATE 
ERROR 


TRACK 
ZERO 


FUNCTION 

The selected disk unit is not ready. 
The unit is not ready if the power 
is off, if no disk is installed, 

or if the disk is not up to speed. 


The FDS is not currently executing 

a read or write operation, nor is it 
seeking a new track. The FDS will 
ignore any commands given when this 
bit is not set. 


An error (parity error) was detected 
by the FDS when reading a sector of 
data. This bit is reset by a new 
read or write command. 


The disk in the selected unit is 
write protected except when a read 
Operation is in progress (Read and 
Formatter Busy). 


A data request has not been serviced 
within the allowable sixty micro- 
second window. 


The selected unit is positioned to 
track zero and the formatter is not 
busy. 


.- not used. 


INSTALLATION OF HARDWARE 


The Model 422 Floppy Disk System is interfaced to the Hewlett 
Packard 21xXX series computers via two identical interface cards 
(P/N 520-50110-02) and a "yY" cable which interconnects between 
the interface cards and the baseplane wiring in the FDS enclosure 
containing drives D and E. In the "standard" software configura- 
tion, channel 10 is used for data and channel 11 is used for 
control/status. Installation of the hardware consists simply of 
plugging in the interface cards and installing the cable: 


1. Unpack the FDS from its shipping box. If shipping 
damage is noted, notify the carrier (see note in the 
shipping box). 

31. k*e¥*Re*K KEE CAUTION *® *¥ *® * * & 
OPEN THE LOADING DOOR OF EACH DRIVE AND 
REMOVE THE SHIPPING INSERT BEFORE POWER 


IS APPLIED. IF THIS PRECAUTION IS NOT 
TAKEN, DAMAGE TO THE DRIVES MAY RESULT: 


+ FF FH FH HF 
+e FF eH OF 


Kk KR RB BF KF KF KR KB KK KR KR KK KR RB KR KE ER ERK 


3. With the computer power off, install the 520-50110-02 
interface cards in slots 10 and ll. Install the cable 
connector labeled "DJ2" onto the card in slot 10: install 
the cable connector labeled "CJ2" onto the card in slot ll. 


4. If a cassette system is to be used with the "standard" 
FDOS software, install its interface card in slot 14 and 
cable it up to the cassette system. If a cassette system 
is not used, install a card in slot 14 to complete the 
interrupt chain. 


5. If the HP-supplied BUF'R'D TTY REG (teletype interface 
card) is to be used, install it in slot 12; connect the TTY 


cable to the card. If it is not used, install a card in 
slot 12 to complete the interrupt chain. 


6. If the photoreader is to be supported under the "standard" 
FDOS software, install its interface card in slot 13 and 
cable it up. If it is not used, install a card in slot 13 to 
complete the interrupt chain. 


7. Apply power to the computer, TTY, and FDS. 


8. Place blank disks into the drives and Bootload the Disk 
Exerciser tape supplied. Configure, define the parameters, and 
start the Exerciser per the instructions in Appendix F. The 
Exerciser should produce a regular incrementing pattern in the 
Switch Register lights as it writes, reads, and compares; bits 

12 through @@ indicate the: last disk address that was accessed 
(see the INTERFACE DESCRIPTION Appendix of this manual). Setting 
bit 15 of the Switch Register causes an error summary to be 
printed on the console device. 


9. After the hardware has run successfully for a while, install 
the software. 
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INSTALLATION OF SOFTWARE 


The "standard" FDOS software package is supplied with a fixed 
configuration of I/O channel assignments and memory size (see 
Section V of this manual). The software package is supplied on 
the "master skeleton disk" containing the following files: 


SYS¢ x LIBE DUP D.35 
SYS1 x LIBF DEBUG Bixler 
SYS2 xCODSK EXER RLOA 
SYS3 EDIT ABCS SD36X 
SYSM ASMBN DPCS » ASMBE 

x SRCE CROS D.36 . ASMBF 

« FSRC FORT D.36X \FOR2E 
LIBN FOR2N D. BP 


The SYS@, SYS1, SYS2, SYS3, and SYSM files are discussed in 
Section V; the EDIT, ASMBN, ASMBE, ASMBF, CROS, DEBUG, DUP, 
FORT, FOR2N, and FOR2E files are discussed in Section VII; the 
LIBN, LIBE, LIBF,. ABCS, DPCS, D.36, D.36X, D.@@, D.35, .IOC., 
RLOA, and SD36X files are discussed in Section VIII; EXER is 
discussed in Appendix F. FSRC is the source of a FORTRAN pro- 
gram to be used later in this section; CODSK will also be dis- 
cussed later in this section. 


SRCE is the source of an assembly language demonstration. pro- 

gram that flashes the Switch Register lights and rings the 

console device bell. Upon execution, the program will type 
COMMAND? TYPE L, R, F, C, B, OR S 


the following responses are valid: 


L (left) - turn on the LSB light of the Switch Register 
and rotate it left for approximately 30 seconds. 


R (right) - turn on the MSB light of the Switch Register 
and rotate it right for approximately 30 seconds. 


F (flash) - flash the Switch Register lights for approxi- 
mately 30 seconds. 


C (count) - do a binary count in the Switch Register for 
approximately 30 seconds. 


B (bells, lights, etc.) - turn on the Switch Register 

lights one at a time; when they are all on, print an up- 
arrow and ring the console device bell; turn off the lights 
One at a time; repeat this cycle five times. 
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S (system) - go to the core-resident System Loader and 
reload the operating system. 


The following narrative describes the installation of the 
"standard" FDOS software package, and gives examples of opera- 
tional procedures. Prior to installing the software, the user 
should study the preceding sections of this manual. 


A. Install the FDS hardware and run the disk Exerciser 
(see the INSTALLATION OF HARDWARE Appendix of this manual). 


B. Install the "master skeleton disk" supplied in disk drive 
D (the left-hand drive of the main FDS enclosure). 


C. Install the FDOS Bootloader into the protected area 
of memory; (see Sections V.C and V.D of this manual). 


D. Execute the Bootloader at X77@@B; a Halt 77B indi- 
cates a successful load of the System Loader. A Halt 
12B or 14B indicates an error was made in loading: 
verify that the Bootloader was entered correctly and try 
again; verify that the hardware is working correctly 

by running the disk Exerciser. 


E. Execute the System Loader, thus loading the remainder 
of the operating system (see Section V.E); this is accom- 
plished by merely pressing RUN. Note that the Switch 
Register displays the last disk command and address trans- 
mitted to the FDS; refer to the INTERFACE DESCRIPTION 
Appendix of this manual. 


F. When the console device bell rings and an "*" is 
printed, FDOS is "on-the-air"; control of the computer 
and associated peripherals is under typed commands (refer 
to Section VI of this manual). 


At this point, one should make a copy of the "master skeleton 
disk" and file the "master skeleton disk" away for back-up 
purposes. This can be accomplished (on a two-drive system) as 
follows: 


A. Install a disk (to become the "master working disk" in 
drive E.- 


B. A disk that is used for the first time in FDOS must 

be formatted, since its sectors are not set up for use 

by FDOS (see Format Disk command in Section VI); formatting 
this disk can be accomplished by typing "FD E". It takes 
approximately thirty seconds to format a disk. 


G-2 


C. Now copy (and verify) the “master skeleton disk" by 
typing | 


RU DUP 


It takes approximately forty-five seconds to copy and 
verify the entire disk (131K words) using DUP; see 
Section VII.F for a description of the Disk Utility 
Package. 


D. Remove the "master skeleton disk" from drive D and 
put it away; take the disk from drive E and install it 
in drive D. Use the ZS command to clear the buffers. 


The above exercise demonstrates calling a program from disk by its 
name. Remember that all of memory (except the Bootloader and Sys- 
tem Loader areas, X7534B through X777B) can be used by the called 
program, Since FDOS is a "disk-resident" operating system. | 


Now we are going to assemble the SRCE file. Place a virgin disk 
in drive E and format it. 


The FDOS processors (ASMB, EDIT, etc.) use the units referred to 
in the base page pointers (191B thru 194B) for all input and 
output; these are analogous to DI, PL, DP, and PK (see Sections 
IV.C.2a, II.D, and II.E). In order for the Assembler to process 
SRCE, the I/O units must be prepared prior to calling it. Basic- 
ally, this is done by temporarily assigning the input unit (DI), 
and "opening" files on the output unit (DP) and high-speed list unit 
(HL). One might think of this as mounting the paper tape of SRCE 
"in the photoreader, loading the high-speed punch with tape (to 
accept the binary output), and loading the line printer with paper 
(to print the listing). Since SRCE is already Queued as the first 
file on Dl, this I/O unit preparation can be accomplished with the 
following commands (we'll use the names DBIN and LIST for the 
binary and listing, respectively, of the demo program): 


AS DI,D1l 
QU DP,DBIN;RF E,DBIN,2 
QU HL,LIST;RF E,LIST,41 


Files arereserved (RF command) for DBIN and LIST, since the assembly 
will go much faster if these files already "exist" on the disk; this 
is because the driver does not have to go back to the Free Storage 
List (on track zero of the disk) each time a sector is written out. 
Now call the Assembler by typing 


RU ASMBN, ,K 


The EAU version (ASMBE) or Floating Point version (ASMBF) of the 
Assembler could have been used, but SRCE does not use these main- 
frame options. In the above call, we have directed the Assembler 
to take its Control Statement from PK. Thus, when it is loaded 
it will type 


TYPE ASMB CONTROL STATMENT: 


To direct the Assembler to generate a binary file on DP and a 
listing and symbol table on HL, then automatically load the 
Cross-Reference Table Generator and generate a cross-reference 
table on HL, type 


ASMB,A,B,1L,T,C 


A two pass assembly is done automatically on SRCE, generating 
the binary and listing on disk; this is possible since the 
computer has complete control of the I/O media and can re- 
position to the beginning of SRCE (no operator intervention 
is required as with paper tape). 


The absolute binary output of the assembler will be written in 
DBIN, and the listing, symbol table and cross-reference table 
Will be written in LIST. When the assembly and cross-reference 
operation is completed, control is returned to the user at the 
console device keyboard (CK) via a transfer to X7549B (see 
Section V.E). 


Note that this entire operation can be accomplished in approxi- 
mately eighty seconds (by a good typist). To illustrate how 
FDOS increases the productivity of the computer system, consider 
the following: | 


*On a computer system with only a teleprinter (ten 
character per second I/O), it would take approximately 
thirty-two minutes just to get a binary paper tape (no 
listing or cross-reference). 


*On a computer system with high-speed paper.tape I/O, 
it would take approximately five minutes just to get 
the binary paper tape. 


*FDOS is thus twenty-four times as productive as the 
system with just a teleprinter, and 3.75 times as 
productive as the high-speed paper tape system. 


*To actually print the listing, symbol table, and 
cross-reference table on a teleprinter, it would add 
approximately 18.5 minutes on all three systems (a line 
printer would be nice). However, on FDOS we have all 
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this on disk, and can print it later (at night?) when there 

is less demand on the computer. Also, once initiated, the 
operation on FDOS does not require operator presence. A note 

of caution, however; listings (by nature) require a great 

deal of storage, and may clutter up the disk. One might 

direct them to cassette or high-speed paper tape. Then(with 
either media) they could be dumped to a Teletype or line printer 
at an off-line print station; this would further decrease the 
demand on the computer. 


To execute the program we just assembled, type 
RD E,DBIN 
To reload and return to the Executive type an "S". 


Now we are going to compile the FSRC file using the FORTRAN 
Compiler. First, prepare the I/O units (DI is still assigned to 
Dl, since the return from DBIN was to X754@B, not X7544B - - 

see Section V.E) by typing 


QU DP,RBIN;RF E,RBIN,2 
QU HL, FLIST 
QU SC,TEMP;RF E,TEMP,19 


We won't reserve a file for FLIST, since only one sector (an 

EOF) will be written on HL (see P3 parameter description of the 
FORTRAN Compiler description, Section VII.E). RBIN will be the 
relocatable binary from pass two, FLIST will be the listing, and 
' TEMP will be the intermediate file. Now call the Non-EAU version 
of FORTRAN by typing 


RU FORT,,,2 


Note that the compiler was directed to take the control statement 
from FSRC, and to compile the second file on DI. Pass one is made 
on FSRC, with the intermediate file written in TEMP. FOR2N (pass 
two) is loaded automatically the intermediate file is processed, 
and the relocatable binary is written in the RBIN file. Upon 
completion, the Executive is reloaded via a transfer to the System 
Loader. 


Now to process RBIN with the configured BCS system (ABCS, Absolute 
Basic Control System file); first, prepare the I/O units by typing 


RS;QU El,RBIN 
QU E2,ABIN, ELIST;RF E,ABIN,45;RF E,ELIST,4 
QU E3,BLIST;RF E,BLIST,5 


Note that disk logical units are referred to here, rather than 
functional units (DI, DP, and HL), since we want to insure that 
we use the proper Unit-Reference numbers (See Section VIII.D). 
ABIN will be the absolute binary file generated by ABCS, ELIST 
will be the entry point list, and BLIST will be the bounds list. 
Call ABCS by typing 


RU ABCS 


When the "*OPT" message is printed, type "PL" to direct ABCS 

to write the absolute binary file (ABIN) followed by an entry point 
list (ELIST) on the system Output unit (E2); when the "*LOAD" 
message is printed, type "NL" to cause ABCS to load from the re- 
locatable library (LIBN) and list the bounds (BLIST) to the 
system list unit (E3); when the "*LST" message is printed, type 
any character except "L" (see Section VIII.D for a description 
of ABCS operation). Upon completion, the Executive is reloaded 
via a transfer to the System Loader. If an entry point or 
bounds list is desired, these can be obtained from E2 or E3 

with the List command. 


Now execute the program by typing 
RD E,ABIN 


The program will be loaded and executed, and will request you 
to type the input data. After it has done the computation it 
will print the result, print another message, and reload the 
Executive via a transfer to the System Loader. 


It should be noted here that FDOS made several transitions 
between the SIO and BCS environments in this compilation, 
relocation, subrouting loading, and execution process: 


*After doing the compilation (FORT) in the SIO 
environment, the BCS environment was entered when 
ABCS was called; upon completion, the Executive 
was reloaded (back to SIO). 


*When the program was executed (RD E,ABIN) the 
BCS environment was again entered; upon completion, 
the Executive was reloaded (back to SIO). 


At this point the user should be reasonably familiar with the 
various aspects of FDOS. If a hardware configuration different 
from the "standard" as defined in Section V.A is desired, the 
following procedure can be used to build a "master working 
disk" (if the "standard" hardware configuration is acceptable 


skip to the end of this section and delete files as is appropriate). 
Basically, the procedure consists of using the System Generator 

to configure and write new "system" files (SYS1, SYS2, SYS3, and 
SYSM), re-defining the teleprinter channel for DEBUG, building 

a new ABCS, and deleting unnecessary files from the disk. 


PROCEDURE FOR BUILDING A "MASTER WORKING DISK" 


KR RK KK KR KK KK KR KK KR KK KK KK KKK KK 


* NOTE: DO NOT REMOVE THE WRITE-PROTECT TAB FROM 
* THE "MASTER SKELETON DISK" SHIPPED FROM THE 


* FACTORY: 
ke Re kK RK RK kK RK Rk kK kK RK KK KR KR KK RK KK KK KK 


+ + + 


1. Install the "master skeleton disk" in drive D (the left-hand 
drive of the main FDS enclosure). . 


2. Enter the Keyed-In Loader per Section V.C. 
3. Load and configure the FDOS Bootloader. per Section V.D. 


4, Bootload the "skeleton" file (SYS@%) using the X77G1B entry of 
the Bootloader with the Switch Register set to 14B (see Section 
ViD.2)% 


5. Remove the "master skeleton disk" from drive D, and install 
a virgin disk in its place. 


6. Halt the computer, turn off all power, configure the inter- 
face cards as desired, and turn all power back on. 


7. Execute the System Generator at location 2B. 


8. Proceed with the System Generation, starting at Section V.F.3; 
reply "YES" to the "FORMAT?" question in step 21. 


9. Install the "master skeleton disk" in drive E. 


10. Use the CODSK Batch file to copy all files (except SYS1, SYS2, 
SYS3, and SYSM) from drive E to drive D; this is accomplished by 


typing 
AS BC,E2;BA CODSK 


Note that CODSK can only be used in conjunction with the "master 
skeleton disk" (or a copy of it), since it assumes certain 
named files are on the disk in drive E. Upon entering the Batch 


mode, CODSK types 


*xkk *&**kBEGINING OF CODSK BATCH OPERATION 
*AS BM, BK 


thus assigning the Batch Message unit to the Bit Bucket. Upon 
completion, CODSK exits the Batch mode (BX), clears the buffers 
(ZS), restores the original SIO configuration (RS), and types 


kee *KKKEND OF CODSK BATCH OPERATION 
*k*k k*KKKREFER TO APPENDIX G, STEP 19. 


A listing of CODSK is shown at the end of this appendix. 


ll. Remove the "master skeleton disk" from drive E, put it in 
its envelope, and store it per the directions on the envelope. 


12. If the console device (teleprinter) is not on channel 12B, 
re-define its channel for DEBUG per Section VII.D.2. 


13. Since the hardware has been re-configured, a new ABCS file 
must be built. This can be accomplished on the disk in drive D. 
First, the files that will not be used on the "working disk" 
(such as CODSK, SRCE, FSRC, LIBE, LIBF, SD36X, ASMBE, ASMBF, and 
FOR2E in a Non-EAU computer) must be deleted, since there is 
room for only thirty-one names in a disk directory. This is 
accomplished via the Delete command. Obtain a Disk Directory, 
and start deleting files from the bottom of the directory as 
appropriate. 


14. At this point, the user should copy any additional BCS modules 
(drivers) that are to be used during DPCS onto drive D: Queue 
each module to a logical unit of D, and then use the Copy command 
to transfer them to disk. 


15. Next, Queue the appropriate BCS modules to Dl; D.36 and D.36x 

should be the first two (if they are to be included), and RLOA 

“should be the last one queued. 

16. Now Queue ABCS, assign the I/O units, and call DPCS by typing 
QU D2,ABCS;AS DI,D1;AS DP,D2;RU DPCS 


The new ABCS will replace the "standard" one; refer to Section 
VIII.A for details of the Disk Prepare Control System. 


17. Since we are now (theoretically) done with the BCS modules, 
delete them from the disk. 


18. Queue the library unit defined during DPCS (the standard is 
D4) with the appropriate library of relocatable subroutines 
(LIBN, LIBE, LIBF, or LIBX). 


19. Install a virgin disk in drive E, format it, and copy the 
disk you just built (use DUP to do this). : 


20. Take one of the disks, write-protect it, label it "master 
configured disk", put it in its envelope, and store it in a 
secure place per the directions on the envelope. Thus, when 
the "working disk" gets misplaced, etc., a copy can easily be 
made. 


21. Repeat Steps 1 thru 4 to configure the Bootloader for the new 
channel assignments. 


If all the above operations work as indicated here, the FDOS may 
be placed into routine operation. 


CODSK Batch File Listing 


*#* *k*e4x REGINING GCF COLSK BATCH OPERATION 

AS B€eRK 

LI B8C:RKee12¢ ** TRIS NUMBER MUST EGUAL CCMMENT LINES 

x*k PATCH FILE TO CCFY ALL DISK FILES FROM 

ke MASTER SYSTEM DISK TO NEw SYSTEM DISK 

%** PROGRAMMERS Deke LA VERNE 1 
e* CySING REGUNS MAY 214 1974 

** PRODUCT IDs 5069 REV. B 
** AS i. 
«* EIT rHtISTORY : | 7 
** 31 MAY 74 CREATE ThE FILE : t 
kk 14 JL 74 RE@ARPAMIIGE FACK LINE ‘ 
** 26 AUG 74 ADD INITLAL GUEUE OF DISK LUOTS 

ke O08 COT 74 ADD ASSIGNMENT GF DL & LP : 
* x 


AS DIvE13AS CP+D1 


SESRE OP eSY¥SOe615CG wee eKAT TG BIySYSOsSTO DPeSYSO3VE e258A 
TQ OTeSKCES TA DPeSRCE 

RF OP eSkC&s1B8sCO eeeAi TA DIeSKCE:TQ DPeSRCESVE eeed 

TQ OLsFSRCYTS OP eFSRC 

RF GPsFSRC4iCO eee As TG CIeFSRCOsSTO GPeFSRCEVE weed 

TQ OIelLiANs TQ OGPeLIEN 

RF OP eLIGNe@Z241CO eeeBbi TQ DIL IANS TO DF eLIBNEVE «eB 

TS OIeLIBE:TO CPeLIFE 

RF QOPeLIBEsBOsCO weeP3 TA OI,LIBEs TG OP,yLIBE? VE ooe8 


G-9 


AITeLTGFSTOC OPeLiIBF 

DEseLiBFse763CO eeehs TA DIeLIBFSTO OPeLIBFSVE eeeB 
OLeCOUSK3TG DF eCCOSK 

MPP seCOUSKs+lUICO eeeAs TS GICOOSKE TG NP eCOOSKIVE eared 
DILECITI TG CPeEDIT 

DP ysFLIT¢103CO ee ebAs TS GCL,EDITS TO GP.,EDITI VE o+eBA 
NTeASMBN3 TU DP eASMEN 

DP eASMBNeSZ25CO wee eGAtTG CIeASMBNE TG DP eASMBNSVE eee BA 
CIeCROS3STEG DPeCRGOS 

MOP eCROSeSiCO eeeBAi TQ DIeCROS?TO OPeCROS?VE +1oeBA 
NLeFGRTSTG OPeFGRT 

OP +eFORTs53:CO eseBAi TS CleFORTITO DPeFORTISVE «¢eBA 
OIleFOR2N3 TU OP e FOREN . 

DP eFOREMe1Loi Cl ee eb ASTO GCIeFORANS TG DPeFORANS VE o+eBA 
DI»sOuPsTG VUP.CUP 

CP»sDUPe4sCG weeEAS TG CLeLCUPS TO CPeOUPSVE «eeBA 
NIsHEEUGi Ta OP eCEEUG 

DPeCEBLGeS38CO eee BATE OL DEBLGS TA NPeDEBUGSVE oe+BA 
DIeEXERi TG CPeEXEF . 
DPeEXEReZ03SCO eee BAS TS OLeEXERS TO CPeEXERi VE oe BA 
DIeABRCSIiTS LPsAECS 

DF eARCSeS2:CO ee eRAi TG C1eARCSITG CPeABCSiVE «eeBA 
DI»~HFCS:T@ OPeCFCS 

PP seOPCSe14sCO eeeBAi TG DI VOPCSiTG OP eOPCSiVE ee BA 
Nise Z26iTQ DPD. 36 

MP ee S6eLEICO wee Bs TO DID 263TH DP eDe ZSE8VE 0908 
Deh. SEXt Te OF eO.ZEXK 

OP ee SEXeLICO wee Es TG OID. 36EX'TO CPeOe SE6XIVE cee 
Di~wGe600;TO OP.O.CO 

PP eNe-COe6i CO ea ehi Te CLG 0GiTO OPeN.OGIEVE e+B 

Cre. 358TH OP e035 

DP eM. 355e73CO eee Bs TU CI. S253:TR DP»eD.353VE oo eb 
NTeelUCes Tw NPeelGle . 

DP a olCCe se SiCD veeBiTG Vie elLOC ei TA UPeoIOCei VE weed 
DI+eFLGASTR OPeKLGA 

CPekKLOAs213CO ees Bs TG DI eRLOAS TO DPeRKLOASVE 098 
D1»SU36Xi Te OCP eSDZ6A 

OP seSESEKe4i CO eeeAs TA OF eSOZ6X'TOA CPeSDSGEXEVE weed 
DIeASMBES TU GPeASMRE 

DPeASMBE*3e23CO ee eASTQ CIVASMEBES TG DPeASMEESVE wee BA 
NYsASMBF ITU DP eASMEF 

DP eASHBFeZZ5CO ee eEATTA LIeASMBFSTO OP eASMRF SVE oeeBA 
NIsFORZES TQ OF eFGR2E 

CheFOCRZE Los CG ee st ASTO GCleFORZE; Tu DPeFORZES VE «ee BA 
DiseSkKCEsFSKC+SOZ6Xi3GU D2~eCUbSK 

NSM SOU e SEX ee CO e S5eeLOCe se RLOASGUE DY LIBN eLIBE eLIAF 
PC+CL et 2sPeE BCSERTESERS 
eee ENG OF COCSK BATCH OPERATION. 

¥*4e REFER TO APPENULX Ge STEP 10. 
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